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PREFACE 



The purpose of this manual is to describe the capabilities of HP 3000 to HP 1000 communications using 
Hewlett-Packard's DS Network Services product, DS/3000. These capabilities include using remote RTE 
commands to the HP 1000, using remote EXEC calls to the HP 1000, performing Remote File Access to 
files at the HP 1000, and perform Program-to-Program communications between the HP 3000 and 
HP 1000, 

The capabilities that exist for HP 3000 to HP 1000 communications are a subset of the total capabilities 
available for HP 3000 to HP 3000 communications or HP 1000 to HP 1000 communications. That is, as 
an HP 3000 user, you will not be able to perform all of the functions available for HP 3000 to HP 3000 
communications. Likewise, not all functions available for HP 1000 to HP 1000 communications are 
possible for HP 3000 to HP 1000 communications. 



NOTE 



Most of the capabilities for HP 3000 to HP 1000 communications are 
programmatic. The interactive interface provides HP 1000 break mode 
commands only. 

This manual will describe HP 3000 to HP 1000 communications assuming that the user is knowledgeable 
about the basic operating principles of both the HP 3000 and HP 1000 or that an HP 3000 user and 
HP 1000 user are working together. 

The operating principles of the HP 3000 Series II/III/30/33/39/40/42/44/48/64 and 68 are described 
in the following manuals. 

• HP 3000 Computer Systems, MPE Commands Reference Manual (30000-90009) (MPE IV 
release); or 

• HP 3000 Computer Systems, MPE V Commands Reference Manual (32033-90006); 

• DS/3000 HP 3000 to HP 3000 User /Programmer Reference Manual (321 85-90001); 

• DS/3000 HP 3000 to HP 3000 Network Administrator Manual (321 85-90002); 

• Fundamental Data Communications Handbook (5957-4634); 

• HP 3000 Computer System, MPE Intrinsics Reference Manual (30000-90010) (MPE IV release); 
or 

• HP 3000 Computer Systems, MPE V Intrinsics Reference Manual (32033-90007); 

• HP 3000 Computer System, System Manager/System Supervisor Reference Manual 
(30000-90014) (MPE IV release); 

• HP 3000 Computer System, Console Operator's Guide (32002-90004) (MPE IV release); 

• HP 3000 Computer Systems, MPE V System Operation and Resource Management Reference 
Manual (320iZ-9000S), 
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NOTE 



The HP 3000 Computer System, MPE V System Operation and Resource 
Management Reference Manual listed above is the MPE V replacement for 
the System Manager /System Supervisor and Console Operator's Guide 
reference manuals. 



The HP 1000 user should refer to the following manuals for information on using DS/1000-IV: 



DS/IOOO-IV User's Manual (91750-90002); 

DS/1000'IV Network Manager's Manual Vol I and II (91750-90010 and 91750-9001 1); 

Getting Started With DS/IOOO-IV (91750-90004); 

DS/1000'IV Quick Reference Guide (91750-90005); 

Data Communications Handbook, Section D (32185-90006); 

RTE-IVB Programmer's Reference Manual (92068-90004); or 

RTE-6/VM Programmer's Reference Manual (92084-90005); or 

RTE-A Programmer's Reference Manual (92077-90007). 



NOTE 



For information about comunications between an HP 1000 and an HP 3000 
from the HP 1000, see the DS/1000-IV User's Manual 
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DESCRIPTION 

Words in syntax statements which are not in italics must be entered exactly as 
shown. Punctuation characters other than brackets, braces and ellipses must also be 
entered exactly as shown. For example: 

EXIT; 

Words in syntax statements which are in italics denote a parameter which must be 
replaced by a user-supplied variable. For example: 

CLOSE filename 

An element inside brackets in a syntax statement is optional. Several elements 
stacked inside brackets means the user may select any one or none of these elements. 
For example: 



User may select A or B or neither. 



When several elements are stacked within braces in a syntax statement, the user must 
select one of those elements. For example: 



B > User must select A or B or C. 

W 

A horizontal ellipsis in a syntax statement indicates that a previous element may be 
repeated. For example: 

[yitemname] . . . ; 

In addition, vertical and horizontal ellipses may be used in examples to indicate that 
portions of the example have been omitted. 

A shaded delimiter preceding a parameter in a syntax statement indicates that the 
delimiter must be supplied whenever (a) that parameter is included or (b) that 
parameter is omitted and any other parameter which follows is included. For 
example: 

itema\Mitemb] IMitemc] 

means that the following are allowed: 

itema 

itema^itemb 
itema yitembyitemc 
itema yyitemc 
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[CONTROLl c/ygr 



When necessary for clarity, the symbol A may be used in a syntax statement to 
indicate a required blank or an exact number of blanks. For example: 

SET [ (modifier) ] A ( Variable) ; 

When necessary for clarity in an example, user input may be underlined For 
example: 

NEW NAME? ALPHA 

Brackets, braces or ellipses appearing in syntax or format statements which must be 
entered as shown will be underlined. For example: 

LET oar[[subscript]] = value 

Output and input/output parameters are underlined. A notation in the description 
of each parameter distinguishes input/output from output parameters. For example: 

CREATE jparml ^ parm2 y flags y error ) 

Shading represents inverse video on the terminal's screen. In addition, it is used to 
emphasize key portions of an example. 



The symbol C 



3 may be used to indicate a key on the terminal's keyboard. For 
example, [RETURN! indicates the carriage return key. 

Control characters are indicated by [CONTROL! followed by the character. For example, 
(CONTROLI Y means the user presses the control key and the character Y simultaneously. 
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Hewlett-Packard's AdvanceNet is a combination of hardware and software products that make it possible 
for Hewlett-Packard computer systems to communicate with one another, and with IBM mainframes as 
well. The connections can be made over hardwired lines, and/or over the public telephone facility, 
and/or across Public Data Networks (PDNs), in any mixture. This capability, coupled with our proven 
remote entry capability to IBM computer systems, provides a total solution to large-company electronic 
data processing (EDP) needs. 

Within the realm of AdvanceNet is the software subsystem that accomplishes HP computer-to-HP 
computer communication over these connecting lines. This software subsystem is the DS Network 
Services product, DS/3000. 

This manual describes how an HP 3000 user can communicate with an HP 1000 computer by establishing 
a communications link using DS/3000. Since each of these computers perform functionally different 
data processing tasks, their association in a network provides you with the benefits of their combined 
capabilities. 

Once the communications link is established, DS/3000 allows you to: 

• Use remote RTE operator commands to the HP 1000 System. The RTE operator commands 
are executed in the remote HP 1 000 but the output resulting from the executed commands 
will appear at your log-on terminal at the HP 3000 end. This is described in Section 3. 

• Use remote EXEC calls to the HP 1000 System. Remote EXEC calls allow you to interface 
with remote I/O devices programmatically. This is described in Section 4. 

• Perform Remote File Access to files in the HP 1000 System, using RFA intrinsics 
programmatically. This capability permits you to access any of the disc files residing at the 
remote HP 1000 as though they reside at your local HP 3000 site. This is described in Section 
5. 

• Perform Program-to-Program Communication between the HP 3000 and HP 1000 system, 
using Program-to-Program (PTOP) intrinsics. This capability permits programs residing in 
different HP computer systems to interactively exchange information with one another in a 
coordinated manner. This is described in Section 6. 

But what exactly does this overall capability mean? It means that a large multidivisional corporation can 
have a truly coordinated world-wide network of computer systems. They are coordinated in the sense of 
tying together the various commercial and industrial functions within each division and factory, and they 
are also coordinated in the larger sense of tying together the various divisions and factories at the 
corporate level. 

For example, imagine a large corporation which has factories in the United States, Canada, France, and 
West Germany. Within each factory there are HP 1000 computer systems performing such functions as 
inventory control, factory data collection, and operations management. With a Hewlett-Packard 
Distributed Systems Network these manufacturing information systems can be tied into an HP 3000 
system which handles the factory's administrative functions (such as finance and accounting). The 
administrative systems of each factory can, in turn, be connected not only to one another but also to a 
mainframe computer (via RJE, MRJE, or SNA NRJE) at corporate headquarters. This overall networking 
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capability makes it possible to perform financial analysis and control at a group and corporate level as 
well as at the individual factories. 

The following summarizes the four ways you can use DS/3000 to communicate with HP 1000 systems: 



REMOTE 
OPERATOR 
COMMANDS 

REMOTE 
EXEC 
CALLS 

REMOTE 

FILE 
ACCESS 



PROGRAM 

TO 
PROGRAM 
COMMUNI- 
CATION 



HP 3000 

From a terminal, issue a remote 
command. 



Write and execute an SPL, 
FORTRAN, PASCAL, or COBOL/II 
program using remote EXEC calls. 

Write and execute an SPL, 
FORTRAN, PASCAL, or COBOL/II 
program using P.emote File Access 
(RFA) intrinsics. 

Write and execute a master or slave 
program in SPL, FORTRAN, 
PASCAL, COBOL, COBOL/II, or 
BASIC using Program-to-Program 
intrinsics. 



HP 1000 

Execute an operator command. 

Execute an EXEC call. 
Access a disc file. 



Write and execute a master or slave 
program in FORTRAN, PASCAL, 
or assembly language using 
Program -to -Program intrinsics. 



In Program-to-Program (PTOP) communications, the programs can reside on either system: 



HP 3000 



Master Program 



Slave Program <- 



or 



HP 1000 



-> Slave Program 



Master Program 
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As a simplified example of a computer network, imagine that you are in the same room with an HP 3000 
(labeled "System A" in Figure 1 - 1) and that an HP 1 000 (labeled "System B") resides in another part of the 
building. These two computers are connected to one another by a cable and a pair of communications 
interfaces. With DS/3000 you can use the processing capability of both the HP 3000 and the HP 1000 
and pass data back and forth between them by entering commands through a single terminal. 

To see how DS/3000 works in this simple example, read through the step-by-step procedure which 
follows. 
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Figure 1-1. HP 3000 to HP 1000 Example 
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Step 1. Sit down at a terminal connected to System A and initiate a session. 



tRETURNI 

: HELLO USER. ACCOUNT 

HP3000 / MPE V G.02.00. WED, OCT 22, 1985, 9:12 AM 

WELCOME TO SYSTEM A. 



Within the context of DS/3000, such a session is referred to as a local session because it is active within 
the HP 3000 to which your terminal is directly connected. This terminology becomes more meaningful 
later, since all you have actually done, so far, is initiate a standard MPE session. At this point, you have 
reached the situation illustrated in Figure 1-2. 



HP3000 
SYSTEM A 



LOCAL 
SESSIQN 



) ] 





Commualcatlons 
Interface 



A 



Interconnecting 
Cable 



HPiOOO 
SYSTEM B 




Figure 1-2. Initiating the Local Session 
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Step 2. Now, open a communications line between System A and System B. Do this by entering a 
:DSLINE command. 

: DSLINE RSYS1000 

DS LINE NUMBER = #L3 



In this example, RSYS1000 is the device class name for the particular line established during system 
configuration (in System A) you wish to use. DS/3000 opens the line and then assigns you a line number 
(3 in this example). This line number is analogous to the file number returned to you by the MPE File 
System when you open a file programmatically using the FOPEN intrinsic. Within your local session, it 
uniquely identifies the particular line that you have opened. This becomes significant only if you must 
open more than one communications line during a session. 



Step 3. Now that you have acquired access to a communications line between System A and System B, 
you may execute remote RTE operator commands. Do this by entering a REMOTE command which 
includes an RTE operator command for the remote system. For example, use the RTE-6/VM command 
TI to determine the remote HP 1000 system time. 

: REMOTE TI 

1985 330 8 39 3 



Step 4. Now determine the time from the local HP 3000 using the MPE SHOWTIME command. 
: SHOWTIME 
MON, NOV 4, 1985, 8:27AM 

Notice that in Steps 3 and 4 it is the presence or absence of the REMOTE prefix which determines whether 
a command is to be executed on the local system or on the remote system. 
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Step 5. Suppose you wish to use the line printer on the HP 1000. This time, instead of having to use the ,-9^ 

REMOTE prefix for each command, try a different technique. Enter the following: 1 



: REMOTE 



This command gives you access to the remote system in such a way that all commands which follow can 
be entered in their normal form (without the prefix REMOTE). The # is the prompt character issued by 
DS/3000 (in place of the usual MPE colon prompt). 



Step 6. Now determine the status of the remote line printer. If the line printer is down, enable it. 

#EQ,6 ^ 

36 DV.12 B U 1 

#UP,6 

#EQ,6 

36 DV.12 B U 



Step 7. The work in System B is now completed so return control to your local session by typing a colon. 



Note that you are now back in the local session in System A (signified by the colon prompt). To close the 
communications line, enter the following variation of the : DSLINE command: 

t PSLINE RSYS1000;CLOSE 

1 DS LINE WAS CLOSED. 



Finally, terminate the local session. 
:BYE 
CPU=1. C0NNECT=11. MON, NOV 4, 1985, 10:16 AM 
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As an HP 3000 user you need only issue a : DSLINE user command from your terminal to establish a link 
with an HP 1000 system. 

However, before you can issue this command successfully, the hardware connections must be made, and 
the DS/3000 and DS/1000-IV software enabled. To do this: 

• The HP customer engineer installs the hardware connection between the systems. 

• The HP 1000 network manager generates a DS/1000-IV network and runs the program DINIT 
(and DSLIN if necessary). Instructions are provided in the Network Manager's manuals. 

• The HP 3000 system supervisor configures the HP 3000 system to include DS/3000. Instructions 
are provided in the System Manager /System Supervisor Manual 

• The HP 3000 system operator initiates the :DSCONTROL command to enable the DS subsystem on 
the communications link. Instructions are provided in Appendix B of this manual. 

Now you can log on to a terminal and issue the : DSLINE user command to establish communications with 
the HP 1000 system. (See Figure 2- 1.) 
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The term session is used- rather loosely in this section to differentiate 
between work done on the local system and work done on the remote 
system (as in local session and remote session). It is not always possible to 
establish a remote session with the HP 1 000 in the literal sense. A literal 
definition of session appears later in this section during a brief discussion of 
Session Access versus Non -session Access. 
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Figure 2-1. DS/3000 Communications Link (HP 3000 to HP 1000) 



OPENING A LINE 



A communications link can be established over a hardwired communications line, over the public 
telephone network, or over an X, 25 Public Data Network (PDN). The procedures for opening hardwired 
lines and for opening telephone lines differ only slightly. Much of the discussion which follows for 
Opening a Hardwired Line and Opening a Telephone Line is identical. The information is repeated for 
each topic so that you need only read that which is appropriate for your situation. Generally, once the 
connection to the remote computer is established, you will perceive no difference in the way DS/3000 
performs. 

Opening a Hardwired Line 

What is a hardwired line? In the general field of data communications there are two types of lines 
commonly referred to as hardwired. The first type is a dedicated path on the public telephone network 
that .is leased from the telephone company for the private use of a computer-to-computer configuration. 
Such a line serves as a permanent connection between the two computers. The other type of hardwired 
line is a cable that is connected directly to the communications I/O interfaces of the two computers. 
Within the context of DS/3000, hardwired always refers to the latter. However, the technique used for 
opening a line is the same for either a direct -connect line or a leased (nonswitched) telephone line. 

The hardwired interconnecting cable connects to each computer by way of a communications interface. 
For a hardwire connection, there are two options available: the Hardwired Serial Interface (HSI), or the 
Intelligent Network Processor (INP) to Programmable Serial Interface (PSI). 

The Hardwired Serial Interface (HSI) connection consists of the HP 30360A HSI interface card for the 
HP 3000 Series II and III (Series 30/33/40/44 and 64 do not support the HSI), and the HP 12889A HSI 
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card for the HP 1000. Each HSI card occupies one card slot in the Multiplexor channel of the HP 3000 
and can accomodate up to four connections to HP 1000s. Only one of the four lines can be used at any 
given time and the HP 3000 console operator has control over which line is active. The HP 3000 Series II 
and III can accomodate a maximum of 2 HSI cards. 

The Intelligent Network Processor (INP) to Programmable Serial Interface (PSI) connection utilizes 
microprocessor-based interface cards in both the HP 3000 and HP 1000, and offloads the task of DS 
transmission management from the CPU to the card. The connection is established by using the 
HP 30010A INP in the HP 3000 Series II and III, or the HP 30020B INP in the HP 3000 Series 
30/33/39/40/42/44/48/64 and 68, or the HP 30244M INP in the HP 3000 Series 37 Computer System. 
On the HP 1000 side, an HP 12834A PSI card is used in the HP 1000 M, E, and F Series and an 
HP 12082A PSI card is used in the HP 1000 A Series. The maximum distance allowed when using this 
connection is one kilometer. 

The hardwire connections are summarized in Table 2-1. 

Table 2-1. Associations between Controllers and Systems (hardwired line) 



System 


Controller 


HP 3000 Series II and III 


HP 3036 OA HSI card 
HP 30010A INP card 


HP 3000 Series 30/33/39/40/42/44/48/64/68 
HP 3000 Series 37 


HP 30020B INP card 
HP 30244M INP card 


HP 1000 M, E, and F Series 


HP 12889A HSI card 
HP 12834A PSI card 


HP 1000 A Series 


HP 12889A HSI card 
HP 12082A PSI card 



^\ 



For most applications, the INP to PSI connection offers a much better method of HP 3000 to HP 1000 
communication. The HSI cards impose substantial overhead on the CPU's (both 3000 and 1000) due to 
the combination of a fast transfer rate (2. 5 megabits/sec) and a small interface buffer size (1 word). The 
INP to PSI connection operates at up to 56 kilobits/sec, but offers 1024 words of buffering on the INP 
and 1072 words of buffering on the PSI. The microprocessors on each card handle the communications 
protocol and handshaking, thus freeing the CPU for more important tasks. 

It is relatively straightforward to obtain access to a hardwired communications line. All you are required 
to do is identify the particular communications interface you wish to use. You do this by specifying the 
device class name or logical device number associated during system configuration with the desired 
interface. In the example in Section 1, the : DSLINE command was used for this purpose, as follows: 
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: DSLINE RSYS1000 

In the : DSLINE command you may also wish to specify the size of the DS/3000 line buffer to be used in 
conjunction with the line. The size of this buffer determines the maximum amount of data that can be 
sent or received in a single physical transmission over the line. Note that a transmission as you normally 
think of it (sending or receiving all or part of a file) may actually consist of many physical transmissions. 
In essence, this buffer size defines a blocking factor for the line, (See Figure 2-2.) A default buffer size 
is established during system configuration, and in most cases (as in the example in Section 1), you will find 
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it satisfactory to let this default value prevail. Linebuffering is the same for both hardwired and 
telephone lines. 
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1200 words of data to be 
transmitted 



First physical transmission: 
512 words (492 words of data 
+ 20 words of DS overhead) 



Second physical transmission: 
512 words (492 words of data 
+ 20 words of DS overhead) 



Third physical transmission: 
236 words (216 words of data 
+ 20 words of DS overhead) 



1200 words of data received 
at remote computer 



Figure 2-2. DS/3000 Line Buffer Example 
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When you execute a :DSLINE command, DS/3000 attempts to give you access to the specified 
communications line and, if successful, informs you of the assigned DS line number by displaying the 
following message at your terminal: 

DS LINE NUMBER = #Lx 

where x is the assigned DS line number. In the example in Section 1, the DS line number 3 was assigned. 
The DS line number is significant only if you open and use more than one communications line 
concurrently within a single local session (see "Opening Multiple Lines" later in this section). 

Now that you have established the physical communications line via the :DSLINE command, you will be 
able to communicate with the remote HP 1000. With RTE-6/VM running on the HP 1000 M, E, and F 
Series, two possibilities exist depending on how the HP 1000 was GEN*d. The two possibilities are session 
access and non -session access. If the HP 1000 is an A Series running RTE-A, only non -session access is 
available. 

SESSION ACCESS, Session access allows you to log on to the remote HP 1000 using either the REMOTE 
HELLO RUSER.RGROUP format or by issuing the REMOTE command and typing HELLO RUSER.RGROUP in 
response to the remote prompt (#). Session access allows you to access those files available for the 
RUSER.RGROUP session you have established. It is also possible to allow the DS/1000-IV software to 
establish a remote session for you by simply typing REMOTE and the RTE operator command. In this case, 
you will be logged on to a default session on the remote HP 1 000. This allows you access to only those 
files assigned to the default session. See the DS/ 1000 -IV Usefs Manual for details. 

NON-SESSION ACCESS. If the HP 1000 M, E, or F Series was GEN'd for non-session access or if the 
HP 1000 computer is an A Series, it is not possible to establish a session with a set of files belonging to a 
particular group, that is, a REMOTE HELLO is not possible. Once you have established the DS line, you 
have access to all the system files by simply typing the REMOTE command followed by the HP 1000 
command. RTE-A running on the HP 1000 A Series supports only non-session access. 

Opening a Telephone Line 

A DS/3000 communications link can also be established over the public (dial-up) telephone network. In 
such a case, the information passed back and forth between the two computers travels over the same lines 
that are used for normal voice traffic. Each computer is interfaced to the telephone lines by way of a 
modem. (The term modem is a contraction of MOdulator-DEModulator.) A modem is a device that 
translates digital signals (electrical impulses) generated by a computer into analog signals (tones) that can 
be transmitted over telephone lines, and vice versa. 

The modem connects to the HP 3000 or the HP 1000 through the use of a communications interface. For 
the HP 3000 Series II and III, an HP 30055A SSLC card or an HP 3001 OA INP interface may be used. 
For the HP 3000 Series 30, 33, 39, 40, 42, 44, 48, 64, or 68, an HP 30020B INP interface is used, while 
for the HP 3000 Series 37, an HP 30244M INP interface is required. The HP 12793A BISYNC MODEM 
PSI card is used in the HP 1 000 M, E, and F Series and the HP 1 207 3 A BYSYNC MODEM PSI card is used 
in the HP 1000 A Series. Refer to Table 2-2 for a summary of the hardware requirements for an 
HP 3000 to HP 1000 modem connection. 
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Table 2-2. Associations between Systems and Controllers (telephone line) 



System 


Controller 


HP 3000 Series II and HI 


HP 3005 5A SSLC I/O card 
HP 30010AINPcard 


HP 3000 Series 30/33/39/40/42/44/48/64/68 
HP 3000 Series 37 


HP 30020B INP card 
HP 30244M INP card 


HP 1 000 M,E, and F Series 


HP 12793A BISYNC MODEM PSI card 


HP 1000 A Series 


HP 12073A BISYNC MODEM PSI card 



It is a little more complex to obtain access to a telephone line than to a hardwired line. First, you must 
identify the particular communications interface (INP or SSLC) you wish to use. You do this by 
specifying the device class name or logical device number of the communication line that was associated 
during system configuration with the desired interface. You can use the :DSLINE command for this 
purpose, as follows: 
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: DSLINE RSYSIOOt) 

In the : DSLINE command, you may also wish to specify the size of the DS/3000 line buffer to be used in 
conjunction with the line. The size of this buffer determines the maximum sized block that can be sent 
or received in a single physical transmission over the line. Note that a transmission as you normally think 
of it (sending or receiving all or part of a file) may actually consist of many physical transmissions. In 
essence, this buffer size defines a blocking factor for the line. (See Figure 2-2.) A default buffer size is 
established during system configuration, and in most cases (as in the example in Section 1), you will find it 
satisfactory to let this default value prevail. Linebuffering is the same for both hardwired and telephone 
lines. 

Next, you may wish to supply a set of identification (ID) sequences to be used in verifying that the desired 
pair of computers are connected to one another. This is discussed under "ID Sequences" later in this 
section. Briefly, however, you may supply an ID sequence that identifies your HP 3000 and one or more 
ID sequences that identify those remote computers with which your HP 3000 may validly be connected. 
When a telephone connection is established between your HP 3000 and a remote HP 1000, the two 
computers exchange ID sequences and their validity determines whether or not the connection is to 
remain in effect. You use the : DSLINE command to supply ID sequences, as follows: 

: DSLINE RSYS1000 ; LOCI D=" SYSTEM A" & 
;REMID="SYSTEM X" 

where SYSTEM A is the ID sequence identifying your HP 3000 and SYSTEM X is the ID sequence 
identifying the remote computer with which you want to establish a telephone connection. 

Again, there are default values that can be established during system configuration. In most cases, 
however, you will at least want to explicitly identify the desired remote HP 1000 to be certain that the 
proper connection is being established. 

Now you must establish the physical connection between the two computers by dialing (at the modem) the 
telephone number of the remote computer and responding (at the system console) to the dial request. If 
you wish to have the console operator of your HP 3000 dial the number for you, you may supply the 
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The Communications Link 

desired number in the :DSLINE command and it will be displayed as part of a dial request message at the 
operator*s console. In this case, you would supply the telephone number as follows: 

:DSLINE RSYS1000 ; LOC I D=" SYSTEM A" & 
;REMID="SYSTEM X" & 
;PHNUM=555-1234 

If autodial equipment is installed on the RSYS1000 line, the telephone number supplied in the :DSLINE 
command is used instead of the number configured for the line. If a phone number is not supplied in the 
: DSLINE command, the configured number will be dialed. 

The various possibilities involved in establishing a telephone connection with a remote computer are 
discussed under "Dialing the Remote Computer" later in this section. 

When you execute the : DSLINE command, DS/3000 attempts to give you access to the specified 
communications interface (INP or SSLC) and, if the telephone connection is successfully established, 
informs you of the assigned DS line number by displaying the following message at your terminal: 

DS LIME NUMBER = #Lx 

where x is the assigned DS line number. In the example in Section 1, the DS line number 3 was assigned. 
The DS line number is significant only if you open and use more than one communications line 
concurrently within a single local session (see "Opening Multiple Lines" later in this section). 

Now that you have established the physical communications line via the : DSLINE command, you will be 
able to communicate with the remote HP 1000. With RTE-6/VM running on the HP 1000 M, E, and F 
Series, two possibilities exist depending on how the HP 1 000 was GEN'd. The two possibilities are session 
access and non-session access. If the HP 1000 is an A Series running RTE-A, only non -session access is 
available. 

SESSION ACCESS. Session access allows you to log on to the remote HP 1 000 using either the REMOTE 
HELLO RUSER.RGROUP format or by issuing the REMOTE command and typing HELLO RUSER.RGROUP in 
response to the remote prompt (#). Session access allows you to access those files available for the 
RUSER.RGROUP session you have established. It is also possible to allow the DS/1000-IV software to 
establish a remote session for you by simply typing REMOTE and the RTE operator command. In this case, 
you will be logged on to a default session on the remote HP 1000. This allows you access to only those 
files assigned to the default session. See the DS/IOOO-IV User's Manual for details. 

NON-SESSION ACCESS. If the HP 1000 computer M, E, or F Series was GEN'd for non-session access 
or if the HP 1 000 is an A Series, it is not possible to establish a session with a set of files belonging to a 
particular group, that is, a REMOTE HELLO is not possible. Once you have established the DS line, you 
have access to all the system files by simply typing the REMOTE command followed by the HP 1000 
command. RTE-A running on the HP 1 000 A Series supports only non-session access. 

Specifying a Line 

As you have seen, in order to open either a hardwired communications line or a dial-up telephone line, 
you must specify a device class name or logical device number identifying the particular communication 
line that is associated with a specific INP, HSI, or SSLC that you wish to use. But how do you figure out 
which name or number to specify? The discussion of this topic may seem a little complex and tedious, 
particularly at first reading. In actual practice, however, once the hardware and software configuration is 
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installed and usable, most DS/3000 sites will post a notice defining all of the available communications 
lines and the proper device class names and logical device numbers for each. In that case, all of the 
detective work described in the following paragraphs is already done for you. 

For each communications interface, there is a pair of associated drivers. First, there is the actual INP, 
HSI, or SSLC driver that directly controls the operation of the interface board. In addition, there is a 
DS/3000 communications driver that controls the operation of the INP, HSI, or SSLC driver. The names 
of these drivers are as follows: 

lOINPO (INP driver) 

CSHBSCO (HSI driver) 

CSSBSCO (SSLC driver) 

lODSO (DS/3000 communications driver, while utilizing the bisync protocol) 

lODSX (DS/3000 communications driver, while utilizing the X. 25 capability) 

If you have only one communications interface (INP, HSI, or SSLC) configured into your system, there is 
no question about which name or number to specify in a ;DSLINE command. If there is more than one 
communications interface, however, you must know (or ask someone who knows) which CSHBSCO, 
CSSBSCO, or lOINPO pertains to the physical line you want to use. 

One or more virtual terminal drivers (lODSTRMO or lODSTRMX) should also be configured into the 
system. The lODSTRMO or lODSTRMX entries allow users on another system to be logged on to this 
system and regulate the number of remote Session Main Processes (SMP) that can be assigned to a given 
line. Each lODSTRMO or lODSTRMX entry is related to the proper communications interface entry by 
the number specified in the column labeled DRT. Figure 2-3 shows logical devices 60 through 64 are 
paired with logical device 12; Figure 2-4 shows logical device 69 paired with logical device 27; Figure 
2-5 shows logical device 71 paired with logical device 29; and Figure 2-6 shows logical device 68 paired 
with logical device 26. 

Now look at the appropriate sample I/O device table produced during system configuration (See Figure 
2-3 and 2-4 for a hardwired line or Figure 2-5 and 2-6 for a telephone line). 

In Figure 2-3, notice that the HSI board entries (logical devices 12 through 15) look the same except for 
the PORTMASK. The PORTMASK specifies which port on the board is to be used. There are also virtual 
terminals (logical devices 60 through 64) referencing back to logical device 1 2. Since only one port on the 
HSI board can be opened at a time, only one block of virtual terminal entries is needed for that board. As 
each port is opened individually by specifying the corresponding dsdevice in the : DSCONTROL command 
(see Appendix B), the system automatically reallocates the block of virtual terminal entries to the proper 
HSI board entry. This reallocation will not, however, show up in the I/O configuration table. 

In Figure 2-3, the shaded items in the column labeled DRIVER NAME show four HSI lines (CSHBSCO) 
configured into the system as logical devices 1 2 through 1 5. For each one of these lines, there is a 
DS/3000 communications driver, lODSO, also configured into the system. Each lODSO entry is related to 
the proper HSI entry by the number specified in the column labeled DRT (the # prefix indicates a back 
reference to a previously defined logical device number). Logical devices 50 through 53 are paired with 
logical devices 1 2 through 1 5, respectively. In this example, it is the device class name or logical device 
number of the appropriate lODSO entry that would be used to specify the desired line. 
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Figure 2-3. Sample I/O Device Table (Hardwired Line with HSI) 
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In Figure 2-4, the shaded items in the column labeled DRIVER NAME show an INP (lOINPO) configured ^.^ 

into the system as logical device 27. (Note that the subtype is 3, indicating hardwired.) For this line, ; 

there is a DS/3000 communications driver (lODSO) also configured into the system. The lODSO entry is "- 

related to the proper INP entry by the number specified in the column labeled DRT (the # prefix indicates 
a back reference to a previously defined logical device number). Logical device 67 is paired with logical 
device 27. In this example, it is the device class name (DSLINE2) or logical device number (67) of the 
lODSO entry that would be used to specify the desired line. 



NOTE 



Figure 2-4 does not show a line configured for X. 25 activity to an 
HP 1000. The back referencing scheme is identical to this example. 
However, the following differences should be noted for an X. 25 
configuration: 

• The communications driver is named lODSX. 

• The device class name or logical device number of an lODSX entry should 
not be used in a :DSLINE command (or in other commands, such as 
DSCOPY). To access the desired remote node, we encourage X.25 Link 
users to enter a nodename whenever a dsdevice is required. See 
"Specifying an X. 25 Line" later in this section. 
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Figure 2-4. Sample I/O Device Table (Hardwired Line with INP) 
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In Figure 2-5, the shaded items in the column labeled DRIVER NAME show one SSLC (CSSBSCO) 
configured into the system as logical device 29. (Note that the subtype is 0, indicating a switched 
telephone line.) Notice the DS/3000 communications driver, lODSO, is related to the SSLC entry by the 
number specified in the column labeled DRT (the # prefix indicates a back reference to a previously 
defined logical device number). Logical device 70 is paired with logical device 29. It is the device class 
name (SDS1) or logical device number (70) of the lODSO entry that would be used to specify the desired 
line. 
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Figure 2-5. Sample I/O Device Table (Telephone Line with SSLC) 
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In Figure 2-6, the shaded items in the column labeled DRIVER NAME show an INP (lOINPO) configured ^^^^^^^^^ 

into the system as logical device 26, (Note that the subtype is 0. This indicates that the INP is used for a "^^ 

dial-up line.) For this line, there is a DS/3000 communications driver, lODSO, also configured into the -. 

system. The lODSO entry is related to the proper INP entry by the number specified in the column 
labeled DRT (the # prefix indicates a back reference to a previously defined logical device number). 
Logical device 66 is paired with logical device 26. It is the device class name (DSLINEl) or logical device 
number (66) of the lODSO entry that would be used to specify the desired line. 
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Figure 2-6. Sample I/O Device Table (Telephone Line with INP) 
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Specifying an X.25 Line ^ ^ 

When specifying an X. 25 line, you do not use the I/O device table. This is because X. 25 uses node names, 
rather than LDEVs, to specify devices. To find out what node names are configured on your system, type 
the following: 

: RUN NETCONF.PUB.SYS 

> LIST 

For more information on NETCONF, see the DS/3000 HP 3000 to HP 3000 Network Administrator 
Manual 



/^mK 



/^^s^X 
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r 



The format of the : DSLINE command, as used to open an HP 3000 to HP 1000 line, is presented here. In 
addition to opening a hardwired line or a telephone line, this command can also be used for closing one or 
more communications lines (discussed later in this section). 



Syntax 






: DSLINE dsdeoice 



[ ; llUEBUF=baffer-size] 

[; EXCLUSIVE] 

[; QUIET] 

[ ; PHflUM^telephone-number] 

[ ; lOCID^local-id-sequence] 

[ ; ^£1^10=^ remote-id' sequence [ , 

[;OPEN] 



, remote-id-sequence] ] 



NOTE 



The complete syntax of the : DSLINE command includes parameters to 
indicate compression or no compression (COMP or NOCOMP). These 
parameters are not available on the HP 3000 to HP 1000 link. 






Parameters 

dsdevice 



j^^ 



(Required). This is the device class name or logical device number assigned 
to the DS/3000 communications driver (lODSO) during system 
configuration, or a logical node name for X. 25. This parameter specifies 
what physical hardwired line or what communications interface (and 
modem) you wish to use. 



NOTE 



X. 25 Link users should always use a node 
name rather than a line identifier. The 
logical node name appears in the 
configuration file for a Public Data Network 
(PDN). A Remote Node (RN) table relates 
the logical node name (specified in this 
command) to the logical device number of 
the appropriate lODSX driver (the X.25 
driver), and to the PDN address of the 
destination node. 
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buffer-size 



(Optional). A decimal integer specifying the size (in words) of the DS/3000 
line buffer to be used in conjunction with the communications line. The 
integer must be within the range 304 < buffer-size < 4095 when used 
with the SSLC or HSI, and between 304 < buffer-size < 1024 when 
used with the INP. The default value is the buffer size entered in response 
to the PREFERRED BUFFER SIZE prompt during system configuration. 
This parameter overrides the MPE configured value when specified by the 
first user to open the given line. 



/^^^ 



EXCLUSIVE 



(Optional). This parameter, if present, specifies that you want exclusive use 
of the communications line. If the requested line or specified 
communications interface is already open and you have specified the 
EXCLUSIVE option, DS/3000 will deny you access to the line (you cannot 
open it). (See "Line Opening Failures" later in this section.) Opening an 
EXCLUSIVE line requires the user to have CS and ND capability. 



QUIET 



(Optional). When you issue the :DSLINE command with this parameter 
added, the message identifying the DS line number is suppressed. 



/<:^K 



The additional parameters that pertain only to opening a telephone line are as follows: 



telephone-number 



(Optional). A telephone number consisting of digits and dashes. The 
maximum length permitted (including both digits and dashes) is 20 
characters. Provided that YES was entered in response to the 
DIAL FACILITY prompt during system configuration, this telephone 
number will be displayed at the operator*s console of your HP 3000 and the 
operator will then establish the telephone connection by dialing that 
number at the modem. (When the autodial feature is present in your 
system, the number provided here is dialed automatically.) The default 
telephone number is the one entered in response to the PHONE NUMBER 
prompt during system configuration. 



/^^ 



local-id-sequence 



(Optional). A string of ASCII characters contained within quotation marks. 
If you wish to use a quotation mark within an ASCII string, use two 
successive quotation marks. The maximum number of ASCII characters 
allowed in the string is 1 6. 



The supplied string of ASCII characters defines the ID sequence that will be 
sent from your HP 3000 to the remote HP 1000 when you attempt to 
establish the telephone connection. If the remote HP 1000 does not 
recognize the supplied ID sequence as a valid one, the telephone connection 
is terminated. The default value is the ASCII string entered in response to 
the LOCAL ID SEQUENCE prompt during system configuration. 



./^^ 
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remote-id" sequence (Optional). Same format as local-id- sequence. 

f^ 

V The supplied strings of ASCII characters define those remote HP 1000 ID 

sequences that will be considered valid when you attempt to establish the 
telephone connection. If the remote HP 1 000 does not send a valid ID 
sequence, the telephone connection is terminated. The default set of 
remote ID sequences consists of the ASCII string entered in response to the 
REMOTE ID SEQUENCE prompt during system configuration. 

OPEN Opens a DS line. 



j^f\ 



1^^ 



#^ 



p 
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Dialing the Remote Computer 

When you are opening a telephone line, you may supply a telephone number as an optional parameter in 
the :DSLINE command to be dialed at the modem connected to the specified INP or SSLC. If you supply 
a telephone number, DS/3000 displays a message on the system console telling the operator to dial that 
number. The operator, after dialing the specified number, enters YES or NO through the system console 
=REPLY command to let DS/3000 know whether or not the telephone connection was successfully made. 
If the operator enters YES, DS/3000 proceeds with the exchanging of ID sequences. If the operator enters 
NO, your : DSLINE request is denied (you cannot open the line). In either case, your terminates keyboard is 
disabled until the console operator responds. 

If you do not supply a telephone number, the sequence of events is as described in the above paragraph, 
except that DS/3000 uses (by default) the first telephone number in the PHONELIST established during 
system configuration. 

If you do not supply a telephone number and no PHONELIST was established during system configuration, 
an I/O request message is displayed at the system console, but it does not include the number to be dialed. 
This method might be used when you will dial the remote HP 1 000 yourself. Remember, however, that 
the console operator must still know whether you dialed successfully, since he must respond to the console 
message before you are granted access to the line. Because your terminal's keyboard is disabled until the 
console operator responds with YES or NO, it is recommended that you always supply a telephone number 
in the : DSLINE command. 

ID Sequences 

Once a telephone connection to a remote HP 1 000 exists, the two computers exchange ID sequences with 
one another. Within the context of DS/3000, an ID sequence is a string of up to 16 ASCII characters that 
identifies a particular computer. 

During system configuration, each computer can be assigned a local ID sequence and a list of remote ID 
sequences. The local ID sequence identifies the particular computer in which it is established; the remote 
ID sequences identify those remote computers with which a communications link can be established over 
the public telephone network. 

In the : DSLINE command, you can supply (as optional parameters) a local ID sequence and one or more 
remote ID sequences to be used instead of those established during system configuration. (See Figure 2-9.) 

When a telephone connection is established between your HP 3000 and a remote HP 1000, the local ID 
sequence supplied in your : DSLINE command is transmitted to the remote system. The remote system 
then transmits its local ID sequence over the telephone line to your HP 3000. The received ID sequence is 
then compared against the remote ID sequence(s) supplied in your : DSLINE command. If that ID 
sequence is found to be valid, the telephone connection is considered successful and DS/3000 grants you 
access to the line. If the ID sequence received is not considered valid, your : DSLINE request is denied (you 
cannot open the line). 

If you do not supply any ID sequences, DS/3000 uses those established during system configuration. If no 
ID sequences were established during system configuration and you do not supply any, no local ID 
sequence is transmitted from your HP 3000 to the remote system and any remote ID sequence received is 
considered valid. 
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Multiple Users 

r 

V Within a DS/3000 environment, it is possible for several users at either end of the line to share access to 

the same physical communications line or for a single user at one end of the line to obtain exclusive access 

to the line. 

As previously mentioned in the discussion of the :DSLINE command, the EXCLUSIVE parameter can be 
used to obtain exclusive access to the specified physical communications line. If you specify this 
parameter (and if access to the line is granted), no other user in either computer v/ill be permitted to open 
that line until you close it. If you ask for exclusive access to a particular line and that line is already in 
use, DS/3000 denies your request (you cannot open the line). (See "Line Opening Failures" later in this 
section. ) 

For hardwired lines and for dial-up lines, multiple users at either end of the line can specify the same 
physical line in iDSLINE commands and obtain access to that line as long as none of them requests 
exclusive access. In such a case, the users* data is multiplexed, so that each user's access to the line appears 
to be completely independent of all others. The exception for a telephone line is that all users, other than 

rthe one who originally opened the line, specify (explicitly or by default) the currently active remote ID 
sequence. Figures 2-7 through 2-1 1 present annotated examples, illustrating successful and unsuccessful 
attempts by different users to obtain access to the same line. 



^\ 






#*^ 
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SYSTEM A 



SYSTEM B 



User X 




RSYS1000 






REMOTE 
SESSION 

REMOTE 
SESSION 



User Y 




z^'^. 



Figure 2-7. Multiple User Example 1 



: HELLO USER.X 



:HELLO USER^Y 



:DSLINE RSYS1000 



:DSLINE RSYS1000 



: REMOTE HELLO USER.X 



: REMOTE HELLO USER.Y 



In this example, User X initiates a local session in System A, obtains access to the hardwired 
communications line that connects System A to System B, and initiates a remote session in System B. 
User Y subsequently initiates a local session in System A, obtains access to the same communications 
line, and initiates a remote session in System B. The request by User Y for the particular 
communications line is granted by DS/3000 because neither user asked for exclusive access to the line. 
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Figure 2-8. Exclusive Option Example 






: HELLO USER.X 



: HELLO USER.Y 



;DSLINE RSYS1 OOP; EXCLUSIVE 



iDSLINE RSYS1000 



: REMOTE HELLO USER.X 






In this example, User X initiates a local session in System A, obtains exclusive access to the hardwired 
communications line that connects System A to System B, and initiates a remote session in System B. 
User Y subsequently initiates a local session in System A and requests access to the same communications 
line. The request is denied by DS/3000 because User X already has exclusive access to the specified 
line. DS/3000 responds with: 

DS LINE IN USE EXCLUSIVELY OR BY ANOTHER SYSTEM. (DSERR 241) 
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Configured Local ID: A 
Configured Remote IDs: B,C 



Configured Local ID: B 
Configured Remote IDs: A,C 



SYSTEM A 



SYSTEM B 
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Figure 2-9. Dial-up Line Multiple User Example 1 



; HELLO USER.X 

; DSLINE RSYS1000 & 

;PHNUM=555-1234 & 
;REMID="B" 

: REMOTE HELLO USER.X 



•.HELLO USER.Y 



iDSLINE RSYS1000 8e 



;PHNUM=555-1234 ge 
;REMID="B" 

: REMOTE HELLO USER.Y 



In this example User X initiates a local session in System A and obtains access to the line identified by 
the device class name RSYS1000. The supplied telephone number is displayed at the system console of 
System A. The console operator establishes the telephone connection by dialing the number at the 
modem connected to the particular line and then enters YES through the system console to let DS/3000 
know that the telephone connection was successfully made. The two computers exchange their 
configured local ID sequences. System A compares the received ID sequence (B) against the remote ID 
sequence specified by User X (REMID="B"). Since the received ID sequence is found to be valid, the 
telephone connection is allowed to remain in effect. User X then initiates a remote session in System B 
over the telephone line from his local log -on terminal. 



y^^^ftV 
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rUser Y subsequently initiates a local session in System A and requests access to the same line 
(RSYSIOOO). Since that line is already open, DS/3000 ignores the supplied telephone number (no 
message is displayed at the system console). Access to the currently opened line is granted to User Y 
because neither user requested exclusive access and User Y specified the currently active remote ID 
sequence (REMID="B") in his DSLINE command. 












j|^5f\ 
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Configured Local ID: A 
Configured Remote IDs: B,C 



Configured Local ID: B 
Configured Remote IDs: A,C 
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Figure 2-10, Dial-up Line Multiple User Example 2 



; HELLO USER.X 

: DSLINE RSYS1000 & 

;PHNUM=555-1234 & 
;REMID="B" 

: REMOTE HELLO USER.X 



: HELLO USER-Y 



:DSLINE RSYS1000 & 



./'^j^ 



;PHNUM=555-2001 & 



;REMID="C*' 



In this example User X initiates a local session in System A and obtains access to the line identified by 
the device class name RSYS1000. The supplied telephone number is displayed at the system console of 
System A. The console operator establishes the telephone connection by dialing the number at the 
modem connected to the particular line and then enters YES through the system console to let DS/3000 
know that the telephone connection was successfully made. The two computers exchange their 
configured local ID sequences. System A compares the received ID sequence (B) against the remote ID 
sequence specified by User X (REMID="B"). Since the received ID sequence is found to be valid, the 
telephone connection is allowed to remain in effect. User X then initiates a remote session in System B 
over the telephone line from his local log -on terminal. 



/^'s^ 
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User Y subsequently initiates a local session in System A and requests access to the same line 
(RSYS1000). Since that line is already open, DS/3000 ignores the supplied telephone number and no 
message is displayed at the system console. The request is denied by DS/3000 because the specified line 
is already open and User Y did not specify the currently active remote ID sequence (B) in the :DSLINE 
command. DS/3000 responds with: 

COMMUNICATIONS INTERFACE ERROR. UNANTICIPATED CONDITION. (DSERR 255) 



/0^^\ 






I^N 



^ 
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Configured Local ID: (none) 
Configured Remote IDs: (none) 



Configured Local ID: (none) 
Configured Remote IDs: (none) 



^^""^ 
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Figure 2-1 L Dial-up Line Multiple User Example 3 



: HELLO USER.X 

; DSLINE RSYS1000 ;PHNUM=555-1234 

: REMOTE HELLO USER.XY 



: HELLO USER>Y 

: DSLINE RSYS1000 ;PHNUM=555-1g34 

: REMOTE HELLO USER.Y 



In this example User X initiates a local session in System A and obtains access to the line identified by 
the device class name RSYS1000. The supplied telephone number is displayed at the system console of 
System A. The console operator establishes the telephone connection by dialing the number at the 
modem connected to the particular line and then enters YES through the system console to let DS/3000 
know that the telephone connection was successfully made. No ID sequences are exchanged because 
none were established (in either computer system) during system configuration and User X didn't specify 
any in the :DSLINE command. User X then initiates a remote session in System B over the telephone 
line from his local log -on terminal. 
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User Y subsequently initiates a local session in System A and requests access to the same line (RSYS1000). 
Since that line is already open, DS/3000 ignores the supplied telephone number (no message is displayed at 
the system console). Access to the currently opened line is granted to User Y because neither user 
requested exclusive access and User Y specified the currently active remote ID sequence (in this case none) 
in his :DS LINE command. 

Note that when no ID sequences are configured and the users don*t supply any in their :DSLINE 
commands, both are taking it on faith that they are connected to the proper remote computer. In this 
example, if User Y had specified PHNUM=555-2001, DS/3000 would have ignored this telephone number 
because the line is already open. User Y would have been connected to the currently active remote 
computer rather than the requested remote system. The total absence of configured or supplied ID 
sequences is safe only under very controlled circumstances. It is strongly recommended that all computers 
in a DS/3000 network that are capable of communicating over telephone lines have default local and 
remote ID sequences established during system configuration and that all line users specify the ID 
sequence of the desired remote computer (REMID=x) in their :DSLINE commands. 



^ Opening Multiple Lines 



Within your local session, you can open more than one physical communications line and you can have 
remote sessions active concurrently over all of the opened lines. However, when operating without X. 25 
Link capability, you are limited to one remote session per physical line at any given time. 

If access to the specified line is obtained, DS/3000 responds to each : DSLINE command by displaying a DS 
line number at your log -on terminal. This line number is roughly analagous to the file number returned 
by the MPE FOPEN intrinsic, in that it is an arbitrary number that uniquely identifies (within your local 
session) your current access to a particular communications line. It has no relationship to the logical 
device number or any other configuration parameter associated with the line, DS line numbers are 
meaningful only if you have more than one line open concurrently within a single local session. In that 
case, you are assigned a separate DS line number for each line you have opened, and you subsequently use 
these numbers to specify which line you wish to use for a given remote command (or sequence of remote 
commands) or to close a particular line without closing the others. 

Figure 2-12 illustrates a situation where a user has established two hardwired communications links 
concurrently from within a single local session. Take a closer look at that situation and examine the 
sequence of commands that was used to create it. 
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Figure 2-12. Multiple Line Example (Hardwired Lines) 

First, the user sat down at a terminal connected to System A and initiated a local session: 
: HELLO USER > ACCOUNT 

HP3000 / MPE V G.02.00. TUE, OCT 22, 1985, 1:37 PM 
WELCOME TO SYSTEM A. 



USER and ACCOUNT are valid user and account names, respectively as defined by the accounting structure 
of System A. 



/^^^ 
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rNow, we have the situation illustrated in Figure 2-13. 
exists between any of the three systems. 



Notice that, at this point, no communications link 
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Figure 2-13. Initiating the Local Session 
(Hardwired Example) 
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Next, the user acquired access to a line between Systems A and B. 
t PSLINE RSYS1 
DSLINE NUMBER = #L3 

RSYS 1 is the device class name (as defined within System A) associated with the particular line. 
Now we have the situation illustrated in Figure 2-14. 
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Figure 2-14. Establishing the Link With System B 
(Hardwired Example) 
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Finally, the user acquired access to a line between Systems A and C: 

: DSLINE RSYS2 

DS LINE NUMBER = #L4 

RSYS2 is the device class name (as defined within System A) associated with the particular line. 

We end up with the situation illustrated in Figure 2- 1 5, which is identical to Figure 2- 1 2 that started 
this example. 
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Figure 2-15. Establishing the Link With System C 
(Hardwired Example) 



2-33 



The Communications Link 



Figure 2-16 illustrates a situation where a user has established two telephone communications links 
concurrently from within a single local session. Take a closer look at that situation and examine the 
sequence of commands that was used to create it. 
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Figure 2-16. Multiple Line Example (Telephone Lines) 
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First, the user sat down at a terminal connected to System A and initiated a local session: 
! HELLO USER, ACCOUNT 

HP3000 / MPE V G^02.00. TUE, OCT 22» 1985, 1:37 PM 
WELCOME TO SYSTEM A- 



i^N 



USER and ACCOUNT are valid user and account names, respectively as defined by the accounting structure 
of System A, 

At this point, we have the situation illustrated in Figure 2-17. Notice that, so far, no communications 
link exists between any of the three systems. 
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Figure 2-17. Initiating the Local Session 
(Dial-up Example) 
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Next, the user acquired access to a telephone connection between Systems A and B. 

t PSLINE RSYS1 ;LOCID="A" ;REMID="B" ;PHNUM=257"8001 

DS LINE NUMBER = #L3 

RSYS 1 is the device class name (as defined within System A) associated with the particular line, A and B 
are the ID sequences identifying Systems A and B, respectively, and 257-8001 is the telephone number of 
the modem connected to the communications interface at System B. 

Now we have the situation illustrated in Figure 2-18. 
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Figure 2-18. Establishing the Link With System B 
(Dial-up Example) 
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Finally, the user acquired access to a line between Systems A and C: 

: DSLINE RSYS2 ;LOCID=*'A" ;REMID="C" ; PHNUM=377-2000 

DS LINE NUMBER = #L4 

RSYS2 is the device class name (as defined within System A) associated with the particular line, A and C 
are the ID sequences identifying Systems A and C, respectively, and 377-2000 is the telephone number of 
the modem connected to the communications interface at System C. 

We end up with the situation illustrated in Figure 2-19, which is identical to Figure 2-16 that started 
this example. 



SYSTEM A 



^^\ 



^^ 




RSYSl 

(OS Une number 3) 



SYSTEM B 



) J /A [2 L SE^ION I 



\ X (DS Uno number 4) 

V 



User's 

Lo£-on 

Ternainal 




#^N 



Figure 2-19. Establishing the Link With System C 
(Dial-up Example) 
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Line Opening Failures 

There are several reasons why a rDSLINE command for opening a communications line might be rejected 
by DS/3000, some of which have already been illustrated earlier in this section. If the rDSLINE 
command is not executed successfully, the error message may help identify the difficulty. The various 
error numbers and messages that might appear as a result of line opening failures are included in the 
summary of error codes and messages in Appendix A. 

The following list summarizes some likely causes of a line opening failure that are common to hardwired 
lines, leased lines, and dial-up telephone lines: 

• You made a syntax error in the : DSLINE command. 

• You gave an erroneous line specification (dsdevice) in the : DSLINE command. (There is no lODSO 
or lODSX entry in the system configuration with the specified device class name or logical device 
number, ) 

• The line was not opened by the local console operator. 

• The line was not opened by the remote console operator. 

• Someone already has exclusive access to the specified line. 

• You asked for EXCLUSIVE access to a line which was already in use. 

• DS/3000 detected a hardware problem (the communications interface board is not responding ^"^^ 
correctly), -^ 

The following list summarizes the additional causes of a line opening failure on a dial-up telephone line: 

• The operator was not able to make the requested telephone connection and entered NO through 
the system console in response to the dial request message. 

• The remote computer rejected your local ID sequence. ^-'^^ 

• The remote computer did not send a valid ID sequence (the received ID sequence did not match 
any of the remote ID sequences that you specified or, if you didn't specify any, did not match any 
of the configured remote ID sequences). 

• The specified line is already in use and the remote ID sequence you supplied did not match the 
one used by the currently connected remote HP 1 000. 

Things to consider if you have experienced a line opening failure: 

• Ensure ; DSCONTROL IdeO ^OPZH was accomplished. 

• Ensure : RU,DINIT has been executed on the RTE system. And, if : DSCONTROL Ideo yOPEti was 
previously done, the: 
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<< HP 3000 COMMUNICATIONS LINK UP >> 

message will be displayed on the HP 1000 system console (displayed only if an HSI interface card 
is used). 

• If previous line activity resulted in an error do : DSLINE ldeO\CLOSZ and then try again to open 
the line with a ; DSLINE IdeO, 

• In case of continuing problems consider any of the following: 

- Enabling the line from the HP 1000 by ; RU»DSMOD and using the /L command to re-enable 
the communication link used to communicate with the 3000. 

- Try to establish a remote session from the HP 1000 to the HP 3000 instead with: 

; RU,RMOTE 
#HELLO... 

- Try to reenable DS/3000 on the HP 3000 by ending the local session with a BYE command and 
then at the console enter: 

t PSCONTROL Idei), SHUT 
; DSCONTROL IdeO, OPZU 

Next> establish a new local session at the HP 3000 with the HELLO command. 

The : DSCONTROL IdeO ^OPEK allocates the software and establishes the logical links between 
software modules. 

On the HP 1000, after the DINIT program is executed, an initialization message is sent 
establishing the buffer size. The initialization reply from the HP 3000 results in satisfactory 
completion, and a printing of the message (displayed only if an HSI interface card is used): 

<< HP 3000 COMMUNICATIONS LINK UP >> 
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CLOSING A LINE 



Once you have opened one or more communications lines, you can close any or all of them by using a 
variation of the : DSLINE command. The line closing format of the : DSLINE command is presented here. 



Syntax 



(dsdeoice "j 

: DSLINE <ds"line-number};CLOSE 
[i J 



Parameters 

dsdeoice 



(Optional). The device class name, logical device number, or logical node 
name specified in the : DSLINE command that opened a particular line. 



ds-line-number 



(Optional) The DS line number assigned to you by DS/3000 when the 
particular line was opened. When this parameter is used, it must appear in 
the format #L«5 where n is the line number (see "Examples" on the 
following page). 



(Optional). This parameter specifies that you wish to close all of the lines 
that you currently have open. 



; CLOSE 



(Required). This parameter specifies that you wish to close the specified 
line(s). 



If no hne identifier {dsdeoice^ ds-line-number, or @) is specified, DS/3000 closes the line that you 
most recently opened. 

Examples 

The following examples illustrate the variations of the : DSLINE command that can be used for closing 
one or more communications lines. 



: DSLINE RSYS1000 ;CLOSE 
This form closes the line that is identified by the device class name RSYS1000. 
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:DSLINE 55;CLOSE 
This form closes the line that is identified by the logical device number 55. 

:DSLINE @;CLOSE 
This form closes all the lines that you currently have open. 

:DSLINE #L3;CL0SE 
This form closes the line that is identified by #L3. 

:DSLINE;CLOSE 
This form closes the line that you most recently opened. 



If you are sharing one or more physical communications lines with other users, the above forms of the 
:DSLINE command close the line(s) for your application only (the other user's applications are not 
J^N affected). 



j^S^^ 



^Sf\ 
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SECTION 



A communications link exists after you have initiated some activity on the remote HP 1000, If the 
remote HP 1000 system allows session access, the DS/3000 software establishes a remote session using the 
RUSER^RGROUP specified in the REMOTE HELLO or uses the default username and groupname specified in 
the HP 1 000 DINIT answer file. 



NOTE 



#^ 



If your system does not support session access (HP 1000 A Series running 
RTE-A), you have access to all system files on the 1000. A REMOTE HELLO 
is not possible. The term session is applied rather loosely in this section to 
differentiate between work done on the local system and work done on the 
remote system (as in local session versus remote session). 



j^^ 






J^N 



You now have two distinct sessions in existence simultaneously from the same log -on terminal: a local 
session (in the HP 3000 to which you first logged on) and a remote session (at the HP 1000 at the other 
end of the communications line). Now pause for a moment to see what this implies. 

Within the local session, you have access to all I/O devices and disc files in your local HP 3000 (subject to 
the usual MPE file security, of course). This is a normal MPE interactive session in every respect. You 
enter MPE commands and use the various language and utility subsystems exactly as you would if 
DS/3000 were not present This local session is running under the username, accountname, and 
groupname specified in the : HELLO command that you used to first log on. All user capabilities and file 
access available to you within the local session are determined by those log -on parameters. 

With remote processing, you have access to the RTE operating system in the remote HP 1 000 by entering 
RTE operator system commands exactly as you would if you were operating at the HP 1 000 and the 
communications link were not present. The RTE operator commands are executed in the remote 
HP 1000, however, the output resulting from the executed commands appears at your log-on terminal 



NOTE 



Only RTE system commands can be executed. There is no copy of FMGR 
for your session. 



For the sake of clarity and as a learning aid, the remainder of this section will treat local and remote 
sessions as separate (and essentially unrelated) entities that use only those resources available in the 
particular system in which they are running. Actually, it is possible to access the I/O devices and disc 
files of the remote HP 1000 computer from your local session. This more advanced activity will be 
covered in Section 4, "Executing Remote EXEC Calls," and Section 5, "Remote File Access." 
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ISSUING REMOTE COMMANDS 

Remember that, in the previous sections, the following sequence of commands was used to establish the 
communications link: 



IRETURNI 
: HELLO USER. ACCOUNT 

HP3000 / MPE V G*02.00. TUE, OCT 22» 1985, 9:05 AM 

WELCOME TO SYSTEM A. 

: DSLINE RSYS1000 

DS LINE NUMBER = #L3 



^'^^^^ 



At this point, the remote session has not been initiated; you are currently in the local session (as signified 
by the colon prompt character). To establish a remote session and execute a remote command, use the 
following construct: 

: REMOTE [ococx] command 

where xxx is the DS line number returned by DS/3000 when the communications line was opened, and 

command is the desired RTE command in its normal format. The DS line number is necessary only if you 

have more than one communications line open simultaneously; if it is omitted, then the line which you /^ 

most recently opened is referenced by default The HP 1000 operator command sent to the remote ) 

processor must follow the command syntax of the remote processor verbatim, and the first character must 

not be a numeric or a comma. Since different versions of RTE support different operator commands, 

consult the documentation provided with your RTE system to determine the exact format of your RTE 

commands. 

In the example in Section 1, the following construct was used to execute a TI command: 

: REMOTE TI 

1985 330 8 39 3 



Because the prefix REMOTE was included, the TI command is executed in the remote session. Although the 
TI command is executed in the remote HP 1 000, the output generated by the command is displayed at 
your local log -on terminal 

Notice, in the above example, that the DS line number associated with the particular communications line 
was not specified (3 in this example). This is because, if no line number is specified, DS/3000 uses (by 
default) the line most recently opened. Only one communications line is open from your local session; so 
DS/3000 uses that line by default. If you had opened a second line, you would need to tell DS/3000 in 
which remote computer the remote command is to be executed. To tell DS/3000, include the appropriate 
DS line number in the remote command, as follows: 
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^^ 



^^Blf\ 



j^'^ 



^^N 
p 



: REMOTE 3 TI 



1985 330 8 39 



The above construct only allows you to execute a single remote command. After the remote command has 
been executed, control returns to your local session, as signified by the colon prompt character. 

But suppose that you want to execute a whole series of remote commands. It would obviously be a 
nuisance to have to prefix each command with the word REMOTE. DS/3000 provides a convenient 
solution to this situation. To execute a series of commands in the remote session, use the following 
construct: 

: REMOTE [xxx] 

where ocoox is again the DS line number of the desired communications line (specifying in which remote 
HP 1000 we want to execute commands). DS/3000 then prompts you for each command by displaying a 
# prompt in column 1 of your terminal (in place of the standard MPE colon prompt). In the example in 
Section 1, this construct was used for entering two remote RTE commands, EQ and UP. 

After reviewing the example in Section 1, try this example: 

; REMOTE 
# LUJ 

LU #1 = E2 
# EQ,2 

16 DVROO B U 



Notice that except for the # prompt (in place of the standard colon prompt) this looks exactly like a 
normal RTE operator's session. All of the commands shown in the previous example are entered through 
the local log -on terminal, but the RTE operator commands are executed in the remote session within the 
remote HP 1000. After each remote RTE command was executed, however, control remained in the 
remote session (as signified by the # prompt character). When the user typed a colon (:) in response to 
the # prompt, control was then returned to the local session (as signified by the colon prompt). The 
remote session is terminated when the : DSLINE command is executed with the CLOSE parameter. 
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Executable RTE Operator Commands 

While in a remote process on the HP 1000 system, you can use the RTE operator commands listed below: 

AB Abort current batch program 

BL Set buffer limits 

BR Set break flag in the ID segment of the named program 

DN Declare I/O device unavailable 

EQ Examine status of I/O device 

GO Restart program out of suspension 

IT Set time intervals for programs 

LU Examine or alter device logical unit assignments 

OF Abort a program 

ON Schedule a program 

PR Change priority of programs ^^ 

PS Program status (L, XL, A) ^ 

RU Start a program immediately 

RT Release disc tracks of a program 

SS Suspend programs 

ST Examine the status of programs 

TI Display the current time (IVB, 6/VM) 

TM Display the current time (L, XL, A) 

TO Examine or alter time-out parameter of an I/O device 

UP Declare I/O device available 

10 Examine I/O configuration (L, XL, A) 



NOTE 



Extreme care should be taken in modifying the RTE real-time clock since 
some programs, including Distributed System software, are scheduled at 
specific times. 

Syntax and further descriptions of these commands are included in the RTE Programmer's Reference 
Manual for each system. 

Using the Remote Subsystem from a Batch Job 

While in a batch job, you can establish a remote session by using the : DSLINE command. 
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The job to be streamed may be similar to the following: 

JOB USER. ACCOUNT 

DSLINE RSYS1000 

REMOTE HELLO RUSER.RACCOUNT 

REMOTE 
#DN,6 
#TO,6,500 
#UP,6 
#: 

REMOTE BYE 

DSLINE;CLOSE 

EOJ 



NOTE 



The remote # prompt is optional. 

An important point to remember is that, once established, the remote session is interacting with the job in 
the same way as it would interact with a terminal. If the remote session detects an error, the error is 
printed to $STDLIST. If the error generates a user prompt, the next record in the job file is read as the 
response (in the same manner as waiting for a character or carriage return on a terminal). The record is 
then lost to the job. 

f^ ISSUING LOCAL COMMANDS 

Whenever the standard MPE colon prompt is displayed at your terminal, you are in the local session. 
Within the local session, you enter MPE commands in their normal format in response to the colon 
prompt. If you are in the midst of a remote session (that is, you used the command : REMOTE, and 
DS/3000 is issuing the # prompt character), you can return control to your local session by entering a 
colon, as follows: 



#1 

In response to the remote colon, control returns to the MPE Command Interpreter of your local HP 3000 
which then prompts you for local commands with the colon prompt character. Note that the remote 
colon does not terminate the remote session; you can resume processing in the remote session by again 
using either of the constructs described under "Issuing Remote Commands". 

TERMINATING A REMOTE SESSION 

To terminate the remote HP 1000 session, issue the ; REMOTE BYE command, or ; DSLINE;CLOSE. In the 
latter case, DS/1000-IV automatically terminates the HP 1000 session. 
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LIMITATIONS 

There are certain limitations when you attempt to access the following RTE subsystems interactively: 

t The Editor. You are unable to edit a file. This is a subsystem that runs under the RTE operating 
system, and there is no facility to direct the dialogue back to the HP 3000 computer. 

• The File Management Program (FMGR). You are unable to run the FMGR control program directly 
with output to an HP 3000 terminal You may create a transfer file containing the FMGR operator 
commands. Then you may run FMGR, specifying the file as follows: 

#RU, FMGR, TRFILE 

< X > 



I 

Command file in which you have 
stored the FMGR commands 

Command to execute FMGR 

Remote prompt from DS/1000-IV 

Output from the File Manager subystem can not be routed over the communications link back to the 
HP 3000. Instead, all output is directed to LUl. 



CAUTION 



The request to RU,FMGR causes the actual FMGR program to run (not a 
copy of it). This will tie up FMGR until the transfer file has completed, 
and keep other users on the HP 1000 from logging on (they will not be able 
to get a copy of FMGR for their session). You must also be very careful to 
EX,SP from FMGR at the end of the transfer file or FMGR will be tied up 
to your session until you terminate it (BYE), or it times out. Exercise 
caution when running FMGR from the HP 3000. 
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EXECUTING REMOTE EXEC CALLS 



SECTION 



In the RTE operating system environment, EXEC calls are used by programs to interact with the system 
executive. DEXEC calls are the remote processing equivalent to the RTE EXEC calls, allowing you to 
interface with remote systems programmatically. A call to DEXEC will be processed by the EXEC 
module of the remote RTE operating system. 

By using DEXEC calls you can direct the RTE System Executive program to: 

• Read from or write to a remote I/O device (excluding a DISC device). 

• Perform I/O operations on remote I/O devices (excluding a DISC device). 

• Schedule dormant remote programs for execution. 

\ • Obtain the curent time from the remote real-time clock. 

• Schedule remote programs for a set time of execution. 

• Obtain status information about a remote I/O device. 

These calls are summarized in Table 4-1, which lists each DEXEC call with its instruction code and the 
function performed. For further information on DEXEC calls, you may want to refer to the appropriate 
RTE Programmer's Reference Manual which contains information on the nearly identical EXEC calls. 

The programmatic DEXEC calls described in this section can be used from an HP 3000 to an HP 1000. 
Prior to their use, the following commands must first be executed: 

i DSCONTROL Idei) \OPEU Console comand on HP 3000 to enable DS/3000. 

On the HP 1000 to schedule various monitors and to 
; RU,DINIT enable the line. 

rin session on the HP 3000 to request the logical use 
: DSLINE Idei) of a DS line to the HP 1 000. 
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Table 4-1. DEXEC Calls 



Instruction 
code 


Call 


Function 


1 


READ 


Reads a record from a remote I/O non-disc device. 


2 


WRITE 


Writes a record on a remote I/O non-disc device. 


3 


I/O CONTROL 


Performs an I/O control operation on a remote I/O 
device. 


10 


PROGRAM SCHEDULE 


Schedules dormant remote programs for execution. 


11 


TIME REQUEST 


Obtains the current time from the remote real-time 
clock. 


12 


TIMED 
PROGRAM SCHEDULE 


Schedules remote programs for a set time of 
execution. 


13 


I/O STATUS 


Obtains I/O status information from a remote I/O 
device. 



/**^ 
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DEXEC CALL ELEMENTS 

EXEC calls and DEXEC calls are comparable in certain aspects such as parameter placement and meaning 
and the values returned in ABREG. DEXEC calls do have one additional parameter than EXEC calls. 
This is the destination parameter, named IDEST. The IDEST parameter is a five word integer array which 
contains the device class name or logical device number of the DS device and the DS line number. A 
complete description of Z Of Sf appears for each of the calls in this section. 



NOTE 



ir 



In the discussion of each DEXEC call which follows in this section, you may 
be asked to refer to the RTE Programmer's Reference Manual appropriate 
for your HP 1000 system for RTE specific details. You may find that the 
names of the parameters for each call vary slightly depending on which 
RTE manual you reference. 



The format of a typical DEXEC call appears as follows: 






DEXEC call formats described in this section include superscripts that describe the types of parameters 
and whether they must be passed by value instead of by reference. The superscripts have the following 
meanings: 



BA 


byte array 


BP 


byte pointer 


D 


double word, by reference 


DA 


double word array 


DV 


double word, by value 


I 


integer by reference 


lA 


integer array 


IV 


integer by value 


L 


logical by reference 


LA 


logical array 


LV 


logical by value 


O-V 


option variable 


R 


real by reference 



J^<^. 
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The superscript 0-V is shown for some DEXEC calls to denote an option variable, meaning that the 

DEXEC call contains optional parameters. '"^ 

Functional Return 

The information returned in the A-register and B-register by DEXEC is the same as that returned by 
EXEC (refer to the appropriate Operating System reference manual) with additional DS/1000-IV error 
conditions and codes. The values of the A- and B-registers are returned immediately after the EXEC call 
is made on behalf of the program on the HP 3000. Applicable DEXEC error codes are listed in Appendix 
A of this manual. 

The following describes the possible outcomes : 

• CCL(<) Error detected by the HP 3000. The binary code in ABREG may contain a 

DEXEC, DS, or MPE file system error code. 

• CCG(>) Completed at communications level, but the HP 1000 detected an error. A four /^sh^ 

character ASCII DEXEC error code is in ABREG. 



• CCE(=) The call was completed successfully. Registers contain status information, not 
error information. 



Error Checking Routine Example 

The following example shows how to check for the failure of a DEXEC call. This example comes from a 
complete programming example that appears at the end of this section. You will need to refer to the 
complete programming example for the definition of the variables. 

PROCEDURE ERROR (CC,QUITNO); 
VALUE CC.QUITNO; 
INTEGER CC.QUITNO; 

BEGIN 

IF CC=-1 THEN << DEXEC RETURNED CCL>> 

BEGIN 

MOVE MSG:="«* HP 3000 DEXEC ERROR: "; 
ASCII (ABREG(1),10,MSG(24)); 
PRINT(HSGW,-25,0); 
END 

ELSE IF CC=1 THEN << DEXEC RETURNED CCG>> 

BEGIN 

MOVE MSG:="«« HP 1000 DEXEC ERROR: "; 
MOVE MSGW(12):=ABREG,(2); 
PRINT(MSGW,14,0); 
END; 
QUIT(QUITNO); 
END; 






'■"■%>> 
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NOTE 



For detailed information about DEXEC calls, refer to the DS/IOOO-IV 
User*s Manual and the EXEC call section of the RTE Programmer's 
Reference Manual appropriate for your system. 






/pN, 
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The read call, instruction code 1, transfers information from a remote I/O device to a local user buffer. 



Syntax 




Functional Return 

upon completion of the call, a doubleword ABREG is returned. Word 1, displayed in the A-register, 
contains status information, the equipment type code, and an availability indicator. Word 2, displayed in 
the B-register, shows the positive number of words or characters actually read, depending on how IBUFL 
was specified in the procedure call (+ for words, - for characters). Refer to the appropriate RTE 
Programmer's Reference Manual for details. 



/<^^^ 



Parameters 

IDEST 

ICODE 
ICNWD 

IBUFR 



IBUFL 



IPRM1 and IPRM2 



Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

Integer by value (required). Specifies the instruction code, which is 1 for a 
read call. 

Integer by reference (required). The control word is an integer which 
specifies the logical control unit of the remote input device and other 
control information required by RTE. 

Integer array (required). An array that will contain the information read 
from the device. You must insure the buffer is large enough to hold the 
amount of data specified by IBUFL 

Integer by reference (required). An integer specifying the number of words 
or characters to be read. If this value is positive it signifies the length in 
words; if it is negative it signifies the length in characters. The maximum 
buffer size for DEXEC requests is 51 2 words (1024 characters). 

Integer by reference (optional). Integer parameters which may be optional, 
depending on the input device. Unlike a local RTE EXEC call, these 
parameters cannot be used to pass additional buffers. 



,/^^^ 
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Error Conditions 

V Each DEXEC call should be followed with a test of the condition code, whose values indicate: 

CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 

call. 

CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 

binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 

CCG Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 

ASCII value is contained in the ABREG. 



0^^ 
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The write call, instruction code 2, transfers information from a local user buffer to a remote I/O device. 



Syntax 



.z'^^^. 



D LA IV I lA I I I 

ABREG: = DEXEC {IDEST,IC0DE,ICNi/DJBUFRyIBUFL\MlPRM1]\MlPRM2]); 



0-V 



Functional Return 

upon completion of the call, a doubleword ABREG is returned. Word 1, displayed in the A-register, 
contains status information, the equipment type code, and an availability indicator. Word 2, displayed in 
the B -register, shows the positive number of words or characters actually read, depending on how IBUFL 
was specified in the procedure call (+ for words, - for characters). Refer to the appropriate RTE 
Programmer's Reference Manual for details. 



Parameters 

IDEST 

ICOOE 
ICNi/D 

IBUFR 

IBUFL 



IPRM1 and IPRM2 



Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

Integer by value (required). The instruction code is 2 for a write call. 

Integer by reference (required). The control word is an integer which 
specifies the logical control unit of the remote input device and other 
control information required by RTE. 

Integer array (required). An array that will contain the information read 
from the device. You must insure the buffer is large enough to hold the 
amount of data specified by IBUFL 

Integer by reference (required). An integer specifying the number of words 
or characters to be read. If this value is positive it signifies the length in 
words; if it is negative it signifies the length in characters. The maximum 
buffer size for DEXEC requests is 512 words (1024 characters). 

Integer by reference (optional). Integer parameters which may be optional, 
depending on the input device. Unlike a local RTE EXEC call, these 
parameters cannot be used to pass additional buffers. 
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Error Conditions 

Each DEXEC call should be followed with a test of the condition code, whose values indicate: 

CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 

call. 

CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 

binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 

CCG Error condition on the HP 1 000 end. Refer to Appendix A for DEXEC error codes. The 

ASCII value is contained in the ABREG. 



^^ 
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The I/O control call, instruction code 3, carries out various operations such as backspace, rewind, and end 
of file, on a remote I/O device. 



/^ 



Syntax 



D LA IV I I 0-V 

ABREG: = DEXEC {IDESTJC0DEJCNhfD\MlPRM1]); 



Functional Return 

The call returns the A-register and B-register in a double word. The A-Register contains the status of 
the device and EQT word 5. The B-Register has no meaning. Refer to the appropriate RTE 
Programmer's Reference Manual for details. 



Paranneters 

IDEST 

ICODE 
ICNl/D 

IPRM1 



Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

Integer by value (required). The instruction code is 3 for an I/O control 
call. 

Integer by reference (required). The control word is an integer which 
specifies the logical unit of the remote I/O device and other control 
information information required by RTE. 

Integer by reference (optional). An optional parameter which is required 
for list output line spacing and various other functions. 
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Error Conditions 

Each DEXEC call should be followed with a test of the condition code, whose values indicate: 
CCE 



CCL 



CCG 



Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 

Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 
binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 

Error condition on the HP 1 000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 
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PROGRAM SCHEDULE 



The remote program schedule call, instruction code 10, designates a dormant remote program for 
execution at the remote system and optionally transfers up to five parameters to the program. 



Syntax 



D LA IV lA I I I 

ABREG: = DEXEC {IDESTJCODEJNAME\MlPRM1]\MlPRM2]\MlPRM3] 

I I 0-V 

[|7P/?AM][jpPftM5]); 



f^ Functional Return 



1^*^' 



#^. 



If the program to be scheduled is dormant, it is scheduled by this call and a zero is returned to the calling 
program in the A -Register. 

If the program to be scheduled is not dormant, it is not scheduled by this call and its status, which is some 
non-zero value, is returned to the calling program in the A-Register. 



Parameters 

IDEST 

ICODE 
INAME 
IPRM1 - IPRM5 



A -register: 


1 
2 
3 
4 
5 
6 



Meaning: 

Good return. 

Program already scheduled. 

I/O suspend. 

Program in wait state. 

Unavailable memory suspend. 

Disc allocation suspend. 

Operator suspend, or program suspend. 



Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

Integer by value (required). The instruction code is 10 for a program 
schedule call. 

Integer array (required). A five character name array of the program to 
schedule. 

Integer by reference (optional). Up to five integer parameters to be passed 
to the scheduled program. 
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PROGRAM SCHEDULE 
Error Conditions 

Each DEXEC call should be followed with a test of the condition code, whose values indicate: 

CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 

call. 

CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 

binary value is contained in the ABREG, This value may also represent a DS or MPE file 
system error. 

CCG Error condition on the HP 1 000 end. Refer to Appendix A for DEXEC error codes. The 

ASCII value is contained in the ABREG. 



/<^5V 
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TIME REQUEST 



^^ 



The time request call, instruction code 1 1, obtains the current time from the remote real-time clock and 
returns it to your terminal. 



Syntax 




/^^'S 






Parameters 

IDEST 

ICODE 
ITIME 



Logical array (required). A five word array that contains, in its first four 
words an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

Integer by value (required). The instruction code is 1 1 for a time request 
call. 

Integer array (required). A five word array in which the current time is 
returned. 

ITIME (1) = tens of milliseconds 

ITIME il) -seconds 

ITIME (3) = minutes 

ITIME (4) « hours 

ITIME iS) « day of year (Julian) 
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Error Conditions 

Each DEXEC call should be followed with a test of the condition code, whose values indicate: 
CCE 



CCL 



CCG 



Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 

Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 
binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 

Error condition on the HP 1 000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 
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TIMED PROGRAM SCHEDULE (Initial Offset) 



The remote timed program schedule call, instruction code 1 2, schedules a remote program for execution at 
specified time intervals, starting after an initial offset time. The requested program is placed in the time 
list. 



Syntax 



D LA IV lA I I I 

ABREG: = DEXEC {IDESTJCODEylNAMEJRESL.MPTLEylOFST); 



Parameters 

IDEST 

ICODE 
INAME 
IRESL 



MTPLE 



lOFST 



Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

Integer by value (required). The instruction code is 1 2 for a remote timed 
program schedule call. 

Integer array (required). A three word integer array which names the 
remote program to put in the time list. 

Integer by reference (required). The value of resolution represents the units 
of time which, when used with the MTPLE value, result in the total time 
intervals. Values for the resolution code are: 

1 = tens of milliseconds 

2 = seconds 

3 = minutes 

4 = hours 

Integer by reference (required). Multiple is a number from to 4095 
which is used with IRESL to give the actual time interval for scheduling. 
For example, if MTPLE is set to 3 and IRESL is 2, the program will be 
scheduled every 3 seconds after an initial offset of lOFST seconds. If the 
parameter MTPLE is set to zero, the program is run only once. 

Integer by reference (required). lOFST is used with the value of IRESL to 
define the initial time offset. It is a negative value representing the 
amount of time to wait before running the program for the first time. 
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TIMED PROGRAM SCHEDULE (Initial Offset) 
Error Conditions 

Each DEXEC call should be followed with a test of the condition code, whose values indicate: 

CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 

call. 

CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 

binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 

CCG Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 

ASCII value is contained in the ABREG. 



/^PV 
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I/O STATUS 



The I/O status call, instruction code 1 3, obtains I/O status information about a remote I/O device. 



Syntax 



D LA IV I L L 0-V 

ABREG: = DEXEC {IDEST,IC0DEJCNWDJSTA1\MlSTA2]); 



Parameters 

IDEST 
ICODE 

icmo 

ISTA1 
ISTA2 



Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

Integer by value (required). The instruction code is 1 3 for an I/O status 
call. 

Integer by reference (required). The control word is an integer which 
specifies the logical unit of the remote I/O device and other control 
information required by RTE. 

Logical (required). The status returned for EQT word 5. See the 
appropriate RTE Programmer's Reference Manual for details. 

Logical (optional). The status returned for EQT word 4. See the 
appropriate RTE Programmer's Reference Manual for details. 



Error Conditions 

Each DEXEC call should be followed with a test of the condition code, whose values indicate: 
CCE 



CCL 



CCG 



Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 

Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 
binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 

Error condition on the HP 1 000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 
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PROGRAM EXAMPLE 

The following is an SPL program which uses the read and write DEXEC calls and also includes an error 
1^*^ checking routine. 

$CONTROL USLINIT 
BEGIN 

COMMENT 

THIS PROGRAM PROMPTS THE USER FOR A MESSAGE TO BE 
WRITTEN TO THE REMOTE HP 1000 CONSOLE, AND THEN 
READS THE REMOTE HP 1000 OPERATOR'S RESPONSE. THE 
RESPONSE IS PRINTED ON THE HP 3000 USER'S TERMINAL; 

BYTE ARRAY BBUFFER(0:79) ; 

BYTE ARRAY MSG(0:79); 

ARRAY DESTINATION (0: 4) :="N0DE1 05 "; 

ARRAY MSGW(«)=MSG; 

INTEGER ARRAY BUFFER (*)=BBUFFER; 

DOUBLE ABREG; 

INTEGER LGTH; 



^>\ 
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INTRINSIC PRINT, READ, QUIT, TERMINATE, ASCII ,P|XEC; 

PROCEDURE ERROR (CC,QUITNO); 
VALUE CCQUITNO; 
INTEGER CC,QUITNO; 



BEGIN 

IF CC=-1 THEN <<DEXEC RETURNED CCL>> 

BEGIN 

MOVE MSG:="«» HP 3000 DEXEC ERROR: "; 
ASCII (ABREG(1),10,MSG(24)); 
PRINT(MSGW,-25,0); 
END 

ELSE IF CC=1 THEN <<DEXEC RETURNED CCG>> 

BEGIN 

rMOVE MSG:="«» HP 1000 DEXEC ERROR: "; 
MOVE MSGW(12):=ABREG,(2); 
PRINT(MSGW,14,0); 
END; 
QUIT(QUITNO); 
END; 

LOOP: 

<<PROMPT USER FOR MESSAGE TO BE SENT TO REMOTE OPERATOR) > 

MOVE MSG:="ENTER MESSAGE FOR HP 1000 OPERATOR: "; 

PRINT(MSGW, -36,7.320); 

LGTH :=READ( BUFFER, -80) ; 

IF (LGTH=0) THEN TERMINATE; 



4-17 



PROGRAM EXAMPLE 



<<SEND MESSAGE TO THE HP 1000 SYSTEM CONSOLE>> 

ABREG : =iiXie; ( DESTI N ATI ON , 2 , 1 , BUFFER , - LGTH ) ; 
IF < THEN ERROR (-1,1) 

ELSE IF > THEN ERR0R(1,2); 

<<READ REMOTE OPERATOR'S RESPONSE>> 

ABREG:=iiiii(DESTINATI0N,1 ,1 .BUFFER, -80) 
IF < then' ERROR (-1,3) 

ELSE IF > THEN ERROR (1,4); 
PRINT(BUFFER, -ABREG(2) ) ; 
GO LOOP; 
END. 
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REMOTE FILE ACCESS 



SECTION 



Through the use of the DS/3000 Remote File Access capability, SPL, PASCAL, FORTRAN, or COBOL/II 
programs running in your local session can access any of the disc files of the remote HP 1 000 (which are 
available to your session) as though they reside at your local HP 3000 site. 



NOTE 



RFA calls can only access FMGR files; you cannot access files in the 
hierarchical file system. 



^f\ 



This section discusses how you can use HP 3000 intrinsics to access HP 1 000 files using DS. 



PROGRAMMATIC ACCESS 



^^ 



Once a communications link has been established between your HP 3000 and remote HP 1000, you can 
use the Remote File Access (RFA) intrinsics to access files available to your session which reside at the 
remote HP 1 000 site. Remote File Access provides the means to create, open, read, write, close, and 
control the files on the remote HP 1000 system. 

Table 5-1 lists the Remote File Access intrinsics, the corresponding RTE File Manager (FMP) call, and a 
corresponding description of each RFA intrinsic call. Refer to the RTE Programmer's Reference Manual 
for further information on FMP calls. 



These RFA intrinsics may be used from the HP 3000 to an adjacent HP 1000. Use of these intrinsics 
requires that the line be opened by the commands: 



0^ 



: DSCONTROL ldeO\0?Z\i 



;RU,DINIT 



Console comand on HP 3000 to enable DS/3000. 



On the HP 1 000 to schedule various monitors and to 
enable the line. 



:DSLINE IdeO 



In session on HP 3000 to request the logical use of a 
DS line to the HP 1000. 



NOTE 



Multiple processes running under the same HP 3000 session cannot access 
the same HP 1000 file via RFA. 



^^ 



Multiple processes under separate HP 3000 sessions may access the same 
HP 1000 file via RFA. 
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Remote File Access 



Table 5-1. RFA and FMP Cross Referencing 



RFA 


FMP 


DESCRIPTION 


DAPOS 


APOSN 


Positions disc files to a record. Record address usually 
obtained through DLOCF. 


DCLOS 


CLOSE 


Close DCB. Make file available to others. Can also 
truncate file. 


DCONT 


FCONT 


Perform I/O control function on non-disc device file, a 
type file. 


DCRET 


CREAT 


Create a file. 


DLOCF 


LOCF 


Return information on opened file. 


DNAME 


NAMF 


Close DCB and rename file. 


DOPEN 


OPEN 


Open file to calling program. 


DPOSN 


PCS NT 


Skip records forward or backward. 


DPURG 


PURGE 


Purge file. Cannot be opened. 


DREAD 


READF 


Read a record from a file to a user buffer. 


DSTAT 


FSTAT 


Return status of all mounted cartridges. 


DWIND 


RWNDF 


Rewind type files, including magnetic tape. Set to 
record 1 in disc file. 


DWRIT 


WRITF 


Write a record from the buffer of a user to file. 



^ 
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Remote File Access 



DESCRIPTION OF ERROR CONDITIONS AND PARAMETERS 

CCE No error with DS/3000 at either end. Check I ERR for result on the HP 1000. If I ERR < 0, 

then there is an FMP error. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 

error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

CCG Not used. 

lERR Integer (required). The error code returned as a result of remote file access problems. 



rThe following example shows how to check for the failure of an RFA call. The example comes from a 
complete programming example that appears at the end of this section. 

Error Checking Routine Example 

PROCEDURE ERRORPROC(CC,QUITNO); 
VALUE CC,QUITNO; 
INTEGER CC,QUITNO; 

BEGIN 

MOVE MSG(0):=" "; 
MOVE MSG(1):=MSG(0),(59); 

IF CC=-1 THEN <<RFA RETURNED CCL>> 

BEGIN 

MOVE MSG:="«» HP 3000 RFA ERROR: "; 
ASCII (ERROR, 10,MSG(22)); 
PRINT(MSGI,-25,0); 
END 
ELSE IF CC=0 THEN <<RFA RETURNED CCE WITH ERROR>> 

BEGIN 

MOVE MSG:="«» HP 1000 RFA ERROR: "; 
ASCII (ERROR, 10, MSG(22)); 
PRINT(MSGI,-25,0); 
END; 
QUIT(QUITNO) ; 
END; 



^^^ 



1^^- 
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Remote File Access 



NOTE 



If the file being accessed at the remote HP 1 000 site is particularly large, 
you may get an error message at the HP 3000 site which indicates a remote 
reject error. In fact, the problem may be that a time out occurred at the 
remote HP 1000 site. The HP 3000 does not have an error message to 
indicate that this is the real problem. You may wish to verify a time out 
problem by looking at the error message that appears on the HP 1000 
system console or simply up the time out specificaton. Refer to the 
DS/1000-IV Network Manager's Manual, Vol. II for details. 



NOTE 



For detailed information on RFA calls, refer to the DS/IOOO-IV User's 
Manual and the RTE Programmer's Reference Manual appropriate for your 
system. 
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5-4 






DAPOS 



Sets the address of the next record for sequential RTE disc file. 



Syntax 




^^PN 



Jff^ 



Parameters 

IDCB 

lERR 
IREC 

IRB 
lOFF 



Logical array (required). The Data Control Block (DCB) is a 4 -word array 
used for each RTE file opened. This is used by the system and should not 
be modified. 

Integer (required). Error code returned as the result of remote file access. 

Integer by value (required). Record number of the next record in a 
sequentially numbered file. The first record is numbered starting with 1. 

Integer by value (optional). Relative block number of the block containing 
the next record, from the DLOCF intrinsic. This parameter must be 
included for correct operation on files with variable length records. 

Integer by value (optional). A word offset, within a block, for the 
beginning of a new record, from DLOCF intrinsic. This parameter must be 
included for correct operation on files with variable length records. 



0^ 



Error Conditions 

Follow each call to an RFA intrinsic with a test of condition codes. 
CCE 



CCL 



CCG 



No error with DS/3000 at either end. Check I ERR for result on the HP 1000. If IERR< 
0, then there is an FMP error. 

Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

Not used. 



#WN. 



NOTE 



The DAPOS intrinsic allows random access of sequential files. 
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DCLOS 



Closes the DCB and makes the RTE file available to other callers. 



Syntax 




Parameters 

IDCB 

lERR 
ITRUN 



Logical array (required). The Data Control Block (DCB) is a four word 
array used for each file opened. This is used by the system and should not 
be modified. 

Integer (required). The error code returned as a result of remote file access. 

Integer by value (optional). The number of blocks in the file to truncate: 

+ N number of blocks to be deleted from the end of the file. 

- N delete all extents and retain the main file. 

the standard close; file closed without truncation. 



CAUTION 



If the number of blocks specified in ITRUN is 
equal to the number of blocks in the file, the 
file is purged. 



Error Conditions 

Follow each call to an RFA intrinsic with a test of condition codes. 
CCE 



CCL 



CCG 



No error with DS/3000 at either end. Check lERR for result on the HP 1000. If IERR< 
0, then there is an FMP error. 

Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

Not used. 
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DCLOS 



r 



NOTE 

The DCLOS intrinsic closes the Data Control Block, and makes the RTE file 
available to other callers. It also gives the user the option of truncating the 
file size when: 



• The file is opened exclusively* 

• The current position is in the main file, not in the extent, 

• The security codes match at open. 

• The number of blocks to be truncated is less than or equal to the number 
of blocks in the file. 
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DCONT 



Sends standard RTE I/O control request to RTE type 0, non-disc, file. 



Syntax 




y^^'^^sv 



Parameters 

IDCB 

lERR 
IC0N1 

IC0N2 



Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

Integer (required). Error codes returned as a result of remote file access. 

Integer by value (required). Control word specifying an action, such as, 
backspace one record or skip a line. See the appropriate RTE Programmer's 
Reference Manual for details. 

Integer by value (optional). This value is required for some of the functions 
defined in ICON!, for example, to define the number of lines to be skipped. 
Refer to the appropriate RTE Programmer's Reference Manual for details. 
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Error Conditions 

Follow each call to an RFA intrinsic with a test of condition codes. 
CCE 



CCL 



CCG 



No error with DS/3000 at either end. Check lERR for result on the HP 1 000. If I ERR < 
0, then there is an FMP error. 

Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

Not used. 
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5-8 



^^ 



DCRET 



Closes the DCB, if open, and creates the named RTE file on the specified disc with the specified number of 
blocks. 



Syntax 










Parameters 

IDCB 

lERR 

NAME 
ISIZE 



ITYPE 



^f\ 
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Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

Integer (required). Number of sectors or error code returned as a result of 
remote files access. 

Logical array (required). RTE file name consisting of up to six characters. 

Logical array (integer). Two word integer array. Word 1 specifes the 
number of blocks desired. If the number of blocks is less than 0, the whole 
disc is used. Word 2, used only for type 2 files, contains the record length 
in words. 

Word 1: The number of blocks desired. 

Word 2: The record length in words. Type 2 files. 

Integer by value (required). Description of the file. 





1 
2 
3 



5 
6 

7 

8 - 32767 



non-disc file 

fixed length 1 2 8- word record 

fixed length records; user defines length 

variable length records; sequential access, automatic 
extents 

ASCII code and source program (otherwise like type 3 
files) 

relocatable binary code (otherwise like type 3 files) 

save program file (otherwise like type 1 files) 

absolute binary (otherwise like type 3 files) 

user defined 
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DCRET 



ISECU 



ICR 



Integer by value (optional). Two character security code of the file. If 0, 
no security (default value); if > 0, any may read, specify to write; if < 0, 
specify to read/write. 

Logical array (optional). Cartridge number; required during the first 
create. A five word array where: 



ICR[0] 



ICR[IHA] 



If 0, use any available cartridge; if >0, 
cartridge reference number; if <0, LU of the 
cartridge. 

ASCII representation of the DS device class 
name, logical device number, or node name for 
DS/X.25. 



See the DS/ 1000 -IV User's Manual for greater detail. 



Error Conditions 



Follow each call to an RFA intrinsic with a test of condition codes. 
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CCE 



CCL 



No error with DS/3000 at either end. Check lERR for result on the HP 1 000. If I ERR < 
0, then there is an FMP error. DCRET will return a positive value in lERR upon successful 
completion to represent the number of sectors allocated to the file. 

Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 



CCG 



Not used. 



NOTE 



The RTE file created by the DCRET intrinsic is left open 
exclusively to the caller upon successful completion of the 
intrinsic call. 



This intrinsic does not create a type file. These are device files, such as line printers or card readers. 
Type files may be created only by FMGR commands at the HP 1 000. 



./'^^X 
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DLOCF 
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Remotely accesses a DCB maintained in RTE to obtain location and status information about the next 



record. 



Syntax 



LA I I I I I III 0-V 

DLOCF {IDCBJERR.IRECmiRB] WlOFF] WJSEC] \§JLU] {§JTY] [|JffEC] ) ; 






j^^N 






Parameters 

IDCB 

lERR 
IREC 

IRB 
lOFF 

JSEC 
JLU 

JTY 
JREC 



Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

Integer (required). The error code returned as a result of remote file access. 

Integer (required). Returns the record number of next sequential record. 
Record numbers begin with 1. 

Integer (optional). Returns the block number of the current block. 

Integer (optional). Returns a word offset, within the current block, at 
which the next record will begin. 

Integer (optional). Returns the number of sectors in the main file. 

Integer (optional). Returns the logical unit number of the file on disc, or of 
the non-disc device for type files. 

Integer (optional). Returns the file type as indicated in DCB. 

Integer (optional). Returns the record size in words. For type files a 
read/write code is returned as follows: 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



W 



Reserved 






R Read (Bit 1 5) = 1 

W Write (Bit 0) = 1 
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DLOCF 

Error Conditions 

Follow each call to an RFA intrinsic with a test of condition codes, _, 

CCE No error with DS/3000 at either end. Check I ERR for result on the HP 1000. If IERR< 

0, then there is an FMP error. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 

error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

CCG Not used. 



yi-3^. 
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IF 



Closes the DCB, if open, and renames the specified RTE file. 



Syntax 



DNAME 



LA I LA LA IV LA 0-V 

DNAME {IDCB,IERR,NAMEyNNAME\MlSECU] WJCR] ) ; 
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Parameters 

IDCB 

lERR 
NAME 
NNAME 
ISECU 

ICR 



I^PN 



Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

Integer (required). Error code returned as a result of remote file access. 

Logical array (required). Current RTE file name up to six characters. 

Logical array (required). New RTE file name up to six characters. 

Integer by value (optional). Two character security code of the old file. 
Remains unchanged. 

Logical array. Required if file is currently open to user. A five word array 
where: 



ICR[0] 



ICR[IH4] 



Cartridge number. If specified the search is limited to 
just that cartridge. If not specified all cartridges are 
searched, but only the first file encountered with the 
old name is changed. 

ASCII representation of the DS device class name, 
logical device number, or node name for DS/X.25. 
DSLINE. 



Error Conditions 

Follow each call to an RFA intrinsic with a test of condition codes. 
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CCE 



CCL 



CCG 



No error with DS/3000 at either end. Check I ERR for result on the HP 1000. If I ERR < 
0, then there is an FMP error. 

Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

Not used. 
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DOPEN 



Closes the DCB, if open, and opens the named RTE file. 



Syntax 



LA I LA IV IV LA 0-V 

DOPEN {IDCB,IERR,NAME\MlOPTN] \MISECU] \MlCR] ) ; 



Parameters 

IDCB 

lERR 
NAME 
lOPTN 



Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

Integer (required). The file type or error code returned as a result of 
remote file access. 

Logical array (required). RTE file name assigned to file of up to six 
characters. 

Integer by value (optional). This value specifies non-standard conditions 
desired when opening a file. See the DS/IOOO-IV Usefs Manual for 
details of the file options available. 



/^^^ 



NOTE 



The parameter lOPTN for: 

• A type 2 file must be modified in update 
mode. 

• A type 3, and greater, file is modified in a 
non-update mode, and writes an EOF 
after each record. 



ISECU 



Integer by value (optional). Two character or binary security code of the 
file. If 0, no security (default value); if > 0, any may read, specify to write; 
if < 0, specify to read/write. 
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NOTE 



l^^v 



r 



^■ 



If the file was created (see DCRET call) with a 
non-zero security code, this parameter must 
be specified and it must match the original 
security code assigned to the file. 



ICR Logical array (required during first open). A five word array where: 

ICR [0] Cartridge number. 

ICff[ l]-[4] ASCII representation of the DS device class name, logical 

device number, or node name for DS/X. 25. 

See the DS/IOOO-IV User's Manual for details (RFA Call Parameter 
Variations). 



Error Conditions 

Follow each call to an RFA intrinsic with a test of condition codes. 

CCE No error with DS/3000 at either end. Check I ERR for result on the HP 1 000. If lERR < 

0, then there is an FMP error. DOPEN will return a positive value if the call is successfully 
completed to represent the file type. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 

error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

CCG Not used. 



#^ 



^^\ 
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DPOSN 

Skips forward or backward a specified number of records, or to an absolute record number. 

Syntax 



LA I IV IV 0-V 
DPOSN {IDCBJERR,NUR\MIR])\ 



Parameters 

^^5 Logical array (required). The Data Control Block (DCB) is a four word 

array used for each RTE file opened. This is used by the system and should 
not be modified. 

•?f '?/? Integer (required). Error code returned as a result of remote file access. 

'Vi/ff Integer by value (required). The number of records to be skipped from the 

current file pointer position: 

+ N number of records forward 

- N number of records backward 

no operation 

Iff Integer by value (optional). The absolute or relative position of the record: 

= NUR indicates a relative position. Default value. 

1 = A/i/ Vindicates an absolute record number within the file. 

Error Conditions 

Follow each call to an RFA intrinsic with a test of condition codes. 

CCE No error with DS/3000 at either end. Check I ERR for result on the HP 1000. If IERR< 

0, then there is an FMP error. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 

error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

CCG Not used. 
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DPURG 



Closes the DCB, if open, and deletes the named RTE file and all its extents. 



Syntax 




Parameters 

IDCB 

lERR 
NAME 

ISECU 
ICR 



Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

Integer (required). Error code returned as a result of remote file access. 

Logical array (required). RTE file name consisting of up to six characters 
that identifies the file to be purged. 

Integer by value (optional). Two character security code of the file. If 0, 
no security (default value); if > 0, any may read, specify to write; if < 0, 
specify to read/write. 

Logical array (required if file not presently open to the user). A five word 
array where: 



ICR[0] 
IC/?[1H4] 



Cartridge number. 

ASCII representation of the DS device class name, 
logical device number, or node name for DS/X. 25. 



#^^ 



Error Conditions 

Follow each call to an RFA intrinsic with a test of condition codes. 
CCE 



CCL 



CCG 



No error with DS/3000 at either end. Check I ERR for result on the HP 1000. If IERR< 
0, then there is an FMP error. 

Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

Not used. 
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DREAD 

Reads a record from the RTE file currently open to DCB, to the user buffer. 

Syntax 



LA I LA IV I IV 0-V 

DREAD {IDCBJERRylBUFylL IML^N] IlpyW] ) ; 



Parameters 

IDCB Logical array (required). The Data Control Block (DCB) is a four word 

array used for each RTE file opened. This is used by the system and should 
not be modified. 

I ERR Integer (required). The error code returned from accessing remote file. 

IBUF Logical array (required). The buffer to which data is read. 

IL Integer by value (required). A read request buffer length that specifies the 

number of words to be transferred. The buffer size is limited to 512 
words. 

LEN Integer (optional). Actual number of words transferred to the 

buffer. If length = - 1, an end of file was read. 

NUM Integer by value (optional). Record number for random access type 1 and 

type 2 files: 

If NUM = 0, transfer starts at current pointer position (default). 
If NUM > 0, transfer starts at absolute record position. 
If NUM < 0, transfer starts at current position. 



Error Conditions 

Follow each call to an RFA intrinsic with a test of condition codes. 

CCE No error with DS/3000 at either end. Check I ERR for result on the HP 1000. If lERR < 

0, then there is an FMP error, 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 

error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

CCG Not used. 



/v^^^^^i^^ 
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/P**^ 



Returns information on all cartridge labels in the RTE system. 



Syntax 



LA I LA 0-V 

DSTAT {ISTAT,IERRyIDEST); 



i^P^ 



Parameters 

ISTAT 

lERR 
IDEST 



Logical array (required). A 12 5- word buffer for directory information. 
See the appropriate RTE Programmer's Reference Manual for details. 

Integer (required). Error code returned as a result of remote file access. 

Logical array (required). ASCII representation of the DS device class name, 
logical device number, or node name for DS/X. 25 (4- word array). 



r 



Error Conditions 

Follow each call to an RFA intrinsic with a test of condition codes. 
CCE 



^^. 



CCL 



CCG 



No error with DS/3000 at either end. Check I ERR for result on the HP 1000. If IERR< 
0, then there is an FMP error. 

Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

Not used. 



J^^. 
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DWIND 

Rewinds RTE device type files and resets RTE disc files to the beginning of the first record in the file. 

Syntax 



LA I 0-V 

DWIND (IDCBylERR); 



Parameters 

IDCB Logical array (required). The Data Control Block (DCB) is a four word 

array used for each RTE file opened. This is used by the system and should 
not be modified. ^ 

I ERR Integer (required). Error code returned as a result of remote file access. 



Error Conditions 

Follow each call to an RFA intrinsic with a test of condition codes. 

CCE No error with DS/3000 at either end. Check lERR for result on the HP 1 000. If lERR < 

0, then there is an FMP error. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 

error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

CCG Not used. 



,/^^^ 
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DWRIT 






Writes a record on the RTE file currently open to the DCB from the user buffer. 



Syntax 



LA I LA IV IV 0-V 

DWRIT {IDCByIERRJBUF,IL\MNUM])\ 



I^PN 



/j^^ 



Parameters 

IDCB 

lERR 
IBUF 
IL 

HUM 



Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

Integer (required). Error code returned as a result of remote file access. 

Logical array (required). Buffer from which data is written to record. 

Integer by value. Number of words from IBUF to be written. The buffer 
size is limited to 5 1 2 words. 

Integer by value (optional). Record number for random access type 1 and 
type 2 files: 

If NUM^ 0, transfer starts at current pointer position (default). 
If NUM > 0, transfer starts at absolute record position. 
If NUM < 0, transfer starts at current position. 



#^ 



Error Conditions 

Follow each call to an RFA intrinsic with a test of condition codes. 



CCE 



CCL 



CCG 



No error with DS/3000 at either end. Check I ERR for result on the HP 1 000. If I ERR < 
0, then there is an FMP error. 

Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

Not used. 



j^"^ 
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RFA EXAMPLE: SPL 



The following SPL/3000 program shows how remote files can be accessed using the remote file access calls ^^ 

to pass files between the HP 3000 and the remote HP 1 000. '^ 

$CONTROL USLINIT 
BEGIN 

COMMENT 

THIS PROGRAM TRANSFERS ONE ASCII RTE FILE TO AN MPE FILE. BECAUSE 

OF DIFFERENCES BETWEEN RTE AND MPE FILE FORMATS, THE RTE FILE IS 

TRANSFERRED AS 72-CHARACTER UNNUMBERED RECORDS. THE USER IS PROMPTED 

FOR THE NAME OF AN RTE FILE OR /E TO EXIT THE PROGRAM. AFTER THE RTE 

FILE IS OPENED, THE PROGRAM PROMPTS FOR THE NAME OF A NEW MPE FILE OR 

/E TO EXIT THE PROGRAM. THE PROGRAM THEN CREATES THE MPE FILE AND THE 

RECORDS ARE TRANSFERRED FROM THE RTE FILE TO THE MPE FILE. 

UPON COMPLETION, THE PROGRAM PRINTS THE NUMBER OF RECORDS 

TRANSFERRED AND TERMINATES; ^ 

INTEGER FILENUM,ERROR,I,LGTH; 
INTEGER NORECORDS:=0; 

LOGICAL OPEN,MOREDATA:=TRUE; 



INTEGER ARRAY DCB(0:4), 

BUFFER(0:32), 

FILENAME(0:13), 

CRN{0:4); 

BYTE ARRAY MSG(0:59); 

BYTE ARRAY NUMBER (0:5); 

BYTE ARRAY FILENAMEB(*)=FILENAME; 

ARRAY MSGI(«)=MSG; 
ARRAY NUMBERI(»)=NUMBER; 

INTRINSIC FOPEN, FWRITE, FCLOSE, PRINT, READ, ASCII, BINARY, 



/^^\ 



PRINT'FILE'INFO, QUIT, liiffiS, liiili, liliii; 



PROCEDURE ERRORPROC(CC,QUITNO); 
VALUE CC,QUITNO; 
INTEGER CC,QUITNO; 

BEGIN 

MOVE MSG(0):=" "; 
MOVE MSG(1):=MSG(0),(59); 

IF CC=-1 THEN <<RFA RETURNED CCL>> 

BEGIN 

MOVE MSG:="«« HP 3000 RFA ERROR: "; 
ASCII (ERROR, 10, MSG(22)); 
PRINT(MSGI,-25,0); 
END 
ELSE IF CC=0 THEN <<RFA RETURNED CCE WITH ERR0R>> 

BEGIN 
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MOVE MSG:="«» HP 1000 RFA ERROR: "; 
ASCII(ERROR,10,MSG(22)); 
PRINT(MSGI,-25,0); 
END; 
QUIT(QUITNO) ; 
END; 

<< BEGIN MAIN C0DE>> 

<< PROMPT USER FOR RTE FILE NAME, 

CARTRIDGE REFERENCE NUMBER AND DSLINE>> 
0PEN:=FALSE; 
WHILE NOT OPEN DO 
BEGIN 

MOVE MSG:="ENTER NAME OF RTE FILE: "; 
PRINT(MSGI,12,5i320); 

rMOVE FILENAMES: =28(" "); 
READ (FILENAME, -6); 
IF FILENAME(0)="/E" THEN GO TO ENDIT; 

MOVE MSG:="ENTER CARTRIDGE REFERENCE NUMBER: "; 

PRINT(MSGI, 17,91320); 

MOVE NUMBER: =6 (" "); 

READ(NUMBERI,-6); 

CRN(O) :=BINARY(NUMBER,6) ; 



^jj^SSBwK 



^PN 



/fp^. 



MOVE MSG:=r "ENTER THE DS DEVICE LDEV OR CLASS NAME: 

PRINT(MSGI,20,%320); 

MOVE CRN(1):=4(" "); 

READ(CRN(l),-8); 

iiJlili|ii(DCB, ERROR, FILENAME,%1 00,0, CRN); 
IF < THEN ERROR PROC (-1,1); 
IF ERROR < THEN ERRORPROC(0,2) ; 
OPEN:=TRUE; 
END; 

<< PROMPT FOR MPE FILE NAME AND CREATE IT>> 
OPEN:=FALSE; 
WHILE NOT OPEN DO 
BEGIN 

MOVE MSG:=" ENTER NAME OF MPE FILE: "; 
PRINT(MSGI,12,f»320); 
MOVE FILENAMEB:=28(" "); 
READ(FILENAME,-28); 

IF FILENAME(0)="/E" THEN GO TO ENDIT; 
FILENUM:=FOPEN (FILENAMES, 4,^344, 36); 
IF < THEN PRINT'FILE'INFO(FILENUM) 
ELSE OPEN:=TRUE; 
END; 

<<TRANSFER DATA>> 
MOREDATA:=TRUE; 
WHILE MOREDATA DO 
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BEGIN ^.^ 

|iHiii(DCB, ERROR, BUFFER (1), 36, LGTH); ^ 

If < THEN ERR0RPR0C(-1,3); - 

IF ERROR < THEN ERR0RPR0C(0,4) ; 
IF LGTH=-1 THEN MOREDATA:=FALSE 
ELSE 
BEGIN 

FOR I:=LGTH+1 UNTIL 35 DO BUFFER (I ):=" "; 
FWRITE(FILENUM,BUFFER(1),36,0); 
IF <> THEN 
BEGIN 

PRINT'FILE'INFO(FILENUM); 
MOREDATA:=FALSE; 
END 

ELSE NOREC0RDS:=NOREC0RDS+1; 
END; 
END; 



ENDIT: 



iilPKDCB, ERROR); 
IF < TH EN ERROR PROC (-1,5); 
IF ERROR < THEN ERR0RPR0C(0,6) ; 
FCL0SE(FILENUM,5il1,0); 
MOVE MSG(0):=" "; 
MOVE MSG(1):=MSG(0),(59); 
MOVE MSG:="NUMBER OF RECORDS TRANSFERRED = 
ASCII (NORECORDS,10,MSG(32)); 
PRINT(MSGI,18,5i40); 

END. 



^ 
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RFA EXAMPLE: FORTRAN 

The following FORTRAN program shows how to create a file on the remote HP 1000. 

$CONTROL I NIT 

PROGRAM RFATR 
C THIS PROGRAM CREATES A NEW FILE ON THE RTE SYSTEM. 
C IT PROMPTS FOR INPUT, AND WRITES EACH RECORD 
C INTO THE NEW FILE USING RFA INTRINSICS. 
C UPON COMPLETION IT DISPLAYS THE CONTENTS, 
C AND CLOSES, AND TRUNCATES THE FILE. 
C 
C 

INTEGER BLOCKNUM, lERR, lERROR, ISIZE, LENGTH 

INTEGER OPTN, RECNM, SECURITY 

INTEGER TRUNCATE, TYPE 
C 

LOGICAL CRTNM(5), DCB(4), NAME(3), SIZE(2) 
^ LOGICAL BUFFER(40) 

CHARACTER ANSW(6), BUFBYTE(72), BUFCHAR»72 
CHARACTER CRTBYTE(8),F0RMALDES*8 
INTEGER BUFINTG(2) 
LOGICAL BUFPRNT(40) 
C 

EQUIVALENCE ( BUFFER, BUFBYTE) 
EQUIVALENCE ( BUFFER, BUFINTG) 

r EQUIVALENCE ( BUFFER, BUFCHAR) 
EQUIVALENCE (CRTNM(2) ,CRTBYTE) 
C 

SYSTEM INTRINSIC D6l05\ DCRET^ DLOCF, D&PEN 
SYSTEM INTRINSIC DPURG^ DREAD^ DWRH 
SYSTEM INTRINSIC FCHECK, FCLOSE, FOPEN 
SYSTEM INTRINSIC FREAD 



JP*^ 



DATA FORMALDES/BH$STDINX / 
C 

C »«»*» MAIN PROGRAM ««»** 
C 

WRITE(6,102) 
102 FORMAT(" BUILD FILE ON REMOTE RTE SYSTEM.") 

WRITE(6,112) 
112 FORMAT (/,"+DSLINE NUMBER = ? ") 

DO 115 1=1,5 
115 CRTNM(I)=f»20040L 
READ(5,*)CRTBYTE 
C 
120 WRITE(6,122) 

122 FORMATC'+SPECIFY NEW FILE NAME = ? ") 
DO 123 1=1,3 

123 NAME(l)=5i20040L 
READ(5,124)NAME 

124 FORMAT (3A2) 

rc 
WRITE(6,126) 
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126 FORMATC'+SPECIFY FILE SECURITY CODE ", ,,^ 

*" (DEFAULT = 0) = ?") 7 

READ (5, 130) SECURITY 
130 FORMAT (A2) 
C 

WRITE(6,134) 
134 FORMATC'+SPECIFY CARTRIDGE NUMBER = ?") 

READ(5,201)CRTNM(1) 
201 FORMAT (A2) 
C 

C PREPARE TO DCRET 
C 

TYPE = 4 
C 

SIZE(1)=%100L 

C 

CALL |iii|(DCB,IERR, NAME, SIZE,TYPE, SECURITY, 

*CRTNM) ^ 

IF (.CC.) 1240,209,209 
209 IF (I ERR) 1260,300,300 
C 

C OPEN TERMINAL AS FILE 
C 
300 IFN=FOPEN(FORMALDES) 
IF(.CC.)305,309,309 

305 CALL FCHECK(IFN,IERROR) 

WRITE(6,306)IERROR "^ 

306 FORMATC FOPEN $STDINX FAILED, CCL. ERROR = ",I6) ; 
STOP 

C 

C FILE NOW CREATED 

C 

309 LENGTH = 36 

310 WRITE(6,312) 

312 FORMATC WRITE COMMANDS, TERMINATE WITH " 

»"'STOP' ",/) ^s^ 

C LOOP 
C 

400 DO 410 1=1,36 

410 BUFFER(I)=^20040L 
C 

C USE FREAD TO ALLOW ' : ' AND ' , ' 
C 

ICNT=FREAD(IFN, BUFFER, 36) 
IF(.CC.) 1050,420,600 
C 

C TEST FOR '??' 
C 

420 IF(BUFINTG(1).EQ.f.37477) GOTO 1100 

C 

C TEST FOR 'STOP' __ 

IF((BUFINTG(1 ) .EQ.%51524) .AND. (BUFINTG(2) 
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r».EQ.%47520)) GO TO 600 
C 

CALL Pi!iI(DCB,IERR, BUFFER, ICNT) 
I F ( . CCT ) "i 020 , 430 , 430 
C 

430 IF (I ERR) 1000,400,400 
C 

C END OF LOOP 
C 
600 WRITE (6,606) 

606 F0RMAT(" BEGIN VERIFICATION:") 
C 

CALL HiiKDCB, lERR) 
IF(.CC7) 1300,620,620 
620 IF(IERR) 1200,675,675 
C 

rC DCLOS COMPLETED. CLOSE TERMINAL. 
C 
675 CALL FCLOSE{IFN,0,0) 
IF(.CC.)690,700,700 
C 
690 WRITE(6,692) 

692 FORMATC FCLOSE FAILED, CCL") 
STOP 
C 

C READ, VERIFY, AND TRUNCATE FILE 
#^ C OPEN 0PTN=2 TO ALLOW TRUNCATION 

700 0PTN=2 

CALL i|;pil(DCB, lERR, NAME, OPTN, SECURITY, 

*crtnmT 

IF(.CC.) 1340,705,705 
705 IF (IERR)1360, 1370, 730 
C 
730 WRITE(6,732)IERR 
0^ 732 FORMATC" FILE TYPE = ",I6) 

C VERIFY LOOP 
C 

ISIZE=36 
740 DO 742 1=1,40 
742 BUFFER(I)=ii20040L 
C 
750 CALL ililKDCB, lERR, BUFFER, ISIZE) 
IF{.CC.) 1380, 755, 755 
C 
755 IF{ISIZE.EQ.O) GO TO 800 
IF(IERR.EQ.-12) GO TO 800 
IF(IERR)1220,760,760 
C 
760 BUFPRNT ( 1 ) =f«20040L 

rDO 758 1=1,39 
758 BUFPRNT(I+1)=BUFFER(I) 
C 
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WRITE(6,762)BUFPRNT 
762 FORMAT (40A2) 
C ^ 

GO TO 740 
C 

C END VERIFY LOOP 
C 

C ENCOUNTERED END OF FILE 
C 
800 CALL ilii|( DCB, lERR, RECNM, BLOCKNUM) 
IF(.CC7) 1320, 802, 802 

802 IF(IERR) 1330,803,803 
C 

803 TRUNCATE=64-(BL0CKNUM+1) 

CALL iiilK DCB, lERR, TRUNCATE) 
IF(.CC.j 1300, 805, 805 
805 IF(IERR) 1200, 820, 820 ^,_ 

820 WRITE(6,822) 
822 FORMATC PROGRAM COMPLETED") 
STOP 
C 

C »«* ERROR CONDITIONS *** 
C 

C DWRIT ERRORS 
C 
1000 WRITE{6,1002)IERR '^ 

1002 FORMATC DWRIT ERROR, lERR = ",I6) . / 

GO TO 600 
C 
1020 WRITE(6,1022)IERR 
1022 FORMATC CCL ON DWRIT, lERR = ",I6) 
STOP 
C 
1050 CALL FCHECK(IFN, lERR) 

WRITE(6,1052)IERR 
1052 FORMATC BAD READ FROM TERMINAL, I ERR = ", 
*I6) 
GO TO 310 
C 
C 
1100 WRITE(6,1110) 
1110 FORMATC GO TO ?? PART ") 

WRITE(6,1120) 
1120 FORMATC THIS PROGRAM CREATES A FILE ", 
«"0N THE RTE.") 
WRITE(6,1130) 
1130 FORMATC IT WRITES THE COMMANDS, THEN", 
*" CLOSES THE FILE.") 
GO TO 310 
C 

1200 WRITE(6,1202)IERR '^ 

1202 F0RMAT(" DCLOS ERROR, lERR = ",I6) 
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STOP 
C 
1220 WRITE(6,1222)IERR 
1222 FORMAT (" DREAD ERROR, I ERR = ",16) 
STOP 
C 
1240 WRITE(6,1242)IERR 

1242 FORMATC CCL ON DCRET, lERR = ",I6) 
STOP 
C 
1260 IF(IERR.EQ.-2) GO TO 1400 

WRITE(6,1262)IERR 
1262 FORMATC* DCRET ERROR, I ERR = ",16) 
STOP 
C 
1270 WRITE(6,1272)IERR 

1272 FORMAT(" CCL ON DPURG, lERR = ",I6) 
STOP 
C 
1290 WRITE (6,1 292) lERR 
1292 FORMAT(" DPURG ERROR, lERR = ",I6) 
STOP 
C 
1300 WRITE (6,1 302) lERR 

1302 FORMAT(" CCL ON DCLOS, lERR = ",I6) 
STOP 
C 
1320 WRITE(6,1322)IERR 

1322 FORMAT(" CCL ON DLOCF, lERR = ",I6) 
STOP 
C 
1330 WRITE(6,1332)IERR 
1332 FORMAT(" DLOCF ERROR, lERR = ",I6) 
STOP 
C 
1340 WRITE(6,1342)IERR 

1342 FORMAT(" CCL ON DOPEN, lERR = ",I6) 
STOP 
C 
1360 WRITE(6,1362)IERR 
1362 FORMAT(" DOPEN ERROR, lERR = ",I6) 
STOP 
C 
1370 WRITE(6,1372) 

1372 FORMAT(" FAILED TO DOPEN FILE, lERR = 0") 
STOP 
C 
1380 WRITE(6,1382)IERR 

1382 FORMAT(" CCL ON DREAD, lERR = ",I6) 
STOP 
C 

C DUPLICATE FILE NAME IN DCRET 
C 
1400 WRITE (6, 1402) 
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1402 FORMATC'+DUPLICATE FILE NAME, WISH TO ", 
»" PURGE (Y/N) = ?") 
READ(5,«)ANSW(1) 
IF(ANSW(1).EQ."N") GOTO 120 
IF(ANSW(1).EQ."Y") GOTO 1410 
GO TO 1400 

1410 CALL ililKDCB, lERR, NAME, SECURITY, CRTNH) 
IF (.CC.j 1270, 1412, 1412 
C 

1412 IF(IERR) 1290, 1420, 1420 
C 
1420 CALL ii||i(DCB, lERR, NAME, SIZE, TYPE, 
•SECURITY, CRTNM) 
IF(.CC.) 1240, 1430, 1430 
C 

1430 IF(IERR) 1260,300,300 
C 

END 
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The preceding chapters describe how to establish communications links between HP 3000 and HP 1000 
computers in order to form a communications network, and how to execute programs in any HP 3000 or 
HP 1000 from a single log-on terminal. Furthermore, the programs running within any HP 3000 or 
HP 1000 in the DS network can, under the proper circumstances, access the hardware or software 
resources available at either end. 

However, for most remote processing applications it is essential that separate user programs be able to run 
simultaneously in separate computers within the network, and also be able to communicate efficiently 
with one another. The DS/30Q0 program-to-program (PTOP) intrinsics described in this chapter provide 
that capability. 

The structure of the two programs that are communicating with one another in this manner is not 
symmetrical. One of them, referred to as the master program, is always in control and is the one that 
initiates all activity between the two programs. The other, referred to as the slave program, is always 
responding to requests received from the master. Those intrinsics used within a master program are 
summarized in Table 6-1 and those used within a slave program are summarized in Table 6-2. 

The master program can reside on either the HP 3000 or HP 1000; the program residing on the system 
opposite of the master is called the slave. The program, either slave or master, residing on the HP 3000 
system can be written in SPL, FORTRAN, COBOL, BASIC, PASCAL, or COBOL/H. The program, slave or 
master, residing on the HP 1000 system can be written in FORTRAN, PASCAL or assembly language. 
The calling sequences of HP 1000 programs are described in the DS/1000-lV User's Manual 



Table 6-1. Master Program -to-Program Intrinsics 



0^. 



HP 1000 



POPEN 

PREAD 

PWRIT 
PCONT 

PCLOS 



HP 3000 



POPEN 

PREAD 

PWRITE 
PCONTROL 

PCLOSE 
PCHECK 



FUNCTION 



Initiates and activates a slave process in a remote system using a 
specified remote program file. 

Sends a request to the remote slave program asking the slave to 
send a block of data back to the master. 

Sends a block of data to the remote slave program. 

Transmits a tag field containing user -defined control information 
to the remote slave program and receives a tag field back from 
the slave. 

Terminates the remote slave process. 

Returns an integer code specifying the completion status of the 
most recently executed master program-to-program intrinsic. 
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Program-To-Program Communications 



The master program-to-program intrinsics are very similar to the MPE process handling and file system 
intrinsics that are used for process-to-process communication within a single-system environment. 



Table 6-2. Slave Program-to-Program Intrinsics 



HP 1000 


HP 3000 


FUNCTION 


GET 


GET 


Receives the next request from the master program. 


ACEPT 


ACCEPT 


Accepts and completes the request received by the preceding GET 
intrinsic call. 


REJCT 


REJECT 


Rejects the request received by the preceding GET intrinsic call. 




PCHECK 


Returns an integer code specifying the completion status of the 
most recently executed slave program-to-program intrinsic. 


FINIS 




Terminates communication with a master program but resources 
are not released. The only released resources are those allocated 
by DS/1000-IV software. The ID segment for the slave will still 
exist. 



NOTE 



PCHECK is not required on the HP 1000 because there is an error parameter 
for each HP 1 000 PTOP call. 



The HP 1000 program-to-program calls perform the same functions as their HP 3000 counterparts, but 
may have slightly different names for parameters. Refer to the DS/IOOO-IV User's Manual for details. 

Once a DS communications link exists between an HP 3000 and HP 1000, a user program (the master 
program) can create and activate a slave program. The PC PEN intrinsic performs this function in place of 
the standard MPE CREATE and ACTIVATE intrinsics. 

When the master and slave program are both executing, the master program can send data (PWRITE) or 
control information (PCONTROL) directly to the slave program. The master can also send a read request 
(PREAD), or control request (PCONTROL) to the slave program asking that the slave send data and/or 
control information back to the master. 

When the master program in a master/slave pair exists on the HP 1000, the master program must make a 
call to HELLO to establish an HP 3000 session before calling POPEN to an HP 3000 slave program. Refer 
to the DS/1000-lV User's Manual for details. 
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Program-To-Program Communications 






Performance Considerations 



The communications system overhead for a PTOP transfer and an RFA transfer is comparable. However, 
when designing applications, PTOP solutions may provide greater throughput compared to RFA because of 
the ability to pack data into the buffer. The actual size of the PTOP transfer depends upon the buffer 
size library used in the HP 1 000 system, along with the configured line size of the communications link as 
set by the DSCONTROL command. The three HP 1000 libraries allow data buffers of approximately 304, 
1072, and 4096 words. 

When an HP 3000 master communicates with an HP 1000 slave, the maximum total data buffer is either 
512, 1024 or 4096 words, depending upon which HP 1000 library is used. When an HP 1000 master 
communicates with an HP 3000 slave, it can transfer up to 4096 words. 
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PTOP Intrlnslcs 

In the following descriptions of program-to-program intrinsics, superscripts are used to describe the types 
of parameters and whether they must be passed by value. The default is by reference. The superscripts 
have the following meanings: 



SUPERSCRIPT MEANING 



#^ 
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BA byte array 

BP byte pointer 

D double 

DA double array 

DV double by value 

I integer 

lA integer array 

IV integer by value 

L logical 

LA logical array 

LV logical by value 

O-V option variable 

R real 
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ACCEPT 

Accepts and completes the requests received by the preceding GET intrinsic call and returns an optional 
tag field to the remote HP 1 000 master program. 

Syntax 



lA lA IV 0-V 

ACCEPT ( \MITAG] {MJARGET] WCOUNT] ) ; 



The ACCEPT intrinsic accepts the request received by the most recent GET intrinsic call, completes the 
requested operation, and transmits an optional tag field back to the remote HP 1 000 master program. 

In the case of a POPEN request, the ACCEPT call transmits an optional tag field, ITAG, to the remote 
HP 1000 master program. 

In the case of a PRE AD request, the ACCEPT call transmits the specified number of words, TCOUNT, from 
TARGET to the remote HP 1 000 master program and transmits an optional tag field, ITAG, to the remote 
HP 1000 master program. See Figure 6-1. 



NOTE 



You may want to refer to Figure 6-3 in conjunction with Figure 6-1. 
Figure 6-3 shows the GET activity with PREAD which would occur prior to 
the ACCEPT activity. 

In the case of a PWRIT request, the ACCEPT call moves the specified number of words, TCOUNT, from the 
DS buffer to TARGET and transmits an optional tag field, IT AG, to the remote HP 1000 master program. 
See Figure 6-2. 



NOTE 



You may want to refer to Figure 6-4 in conjunction with Figure 6-2. 
Figure 6-4 shows the GET activity with PWRIT which would occur prior to 
the ACCEPT activity. 

In the case of a PCONTROL request, the ACCEPT call transmits an optional tag field, ITAG, to the remote 
HP 1000 master program. 
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ACCEPT 
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Figure 6-1, ACCEPT Activity for PREAD 
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Figure 6-2. ACCEPT Activity for PWRIT 
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ACCEPT 
Parameters 

ITAG 
TARGET 



TCOUNT 



Integer array (optional). A 20-word array used for transmitting a tag 
field. The format of the tag field is defined by the master and slave 
programs of the user. 

Integer array (optional). An array for transmitting or receiving blocks of 
data. 

For PREAD requests, this array contains the block of data to be transmitted 
to the remote HP 1 000 master program. 

For PWRITE requests, this array receives the block of data from the DS 
buffer. 

For POPEN and PCONTROL requests, this array has no meaning and should be 
omitted. 

Integer by value (optional). An integer specifying the number of words (if 
positive) or bytes (if negative) to be transmitted or received. 

For PREAD requests, this parameter specifies how many words of data are to 
be transmitted from TAFGET to the remote HP 1 000 master program. 

For PWRITE requests, this parameter specifies how many words of data are 
to be moved from the DS buffer to TARGET, 

For POPEN and PCONTROL requests, this parameter has no meaning and 
should be omitted. 



Error Conditions 

CCE 
CCG 
CCL 



Request completed successfully. 

Not returned. 

An error occurred. Issue a PCHECK intrinsic call to determine the DS/3000 
subsystem or MPE file system eribr code. 
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GET 



|P^ 



Slave callable. Receives the next request from the remote HP 1 000 master program. 

Syntax 



r 



The GET intrinsic receives the next request from the remote HP 1 000 master program and accepts an 
optional tag field, available in IT AG. 

Functional Return 

When the GET intrinsic is executed, it returns to the HP 3000 slave program a number, if un, specifying 
the type of request received from the remote HP 1000 master program: 

ifun Meaning 

A error occurred. This value is returned only when the condition code 
CCL is also returned. Issue a PC HECK intrinsic call with a DSNUM 
parameter of zero to determine what happened. 

1 POPEN request received. 

2 PREAD request received. 

3 PWRIT request received. 

4 PCONT request received. 

5 This value is returned only when the condition code CCG is returned. It 
indicates that a pending MPE File System I/O-without-wait request was 
completed instead of a DS remote I/O request. The parameter lONUMBER 
contains the file number associated with the completed I/O request. 

The GET intrinsic call implicitly issues an IOWAIT(0) intrinsic call. The parameter ifun value of 
indicates that an IOWA IT error occurred. An ifun value of 5 occurs only if you are executing MPE File 
System intrinsic calls without wait in your program and the implicit lOWAIT(O) call completes a pending 
File System I/O request instead of the expected DS remote I/O request. In this case you will have to issue 
another GET call after processing the completed File System I/O request in order to receive the expected 
DS remote I/O request. 



^"^ 



6-7 



GET 
Parameters 

ITAG 
IL 



lONUMBER 



Integer array (optional), A 20-word array used for receiving a tag field 
The format of the tag field is defined by the master and slave programs of 
the user. 

Integer (optional). A word that has meaning only when a PRE AD or PWRIT 
request is received from the remote HP 1 000 master program. For a PREAD 
request, IL contains an integer specifying the number of words requested by 
the remote HP 1000 master program. For a PWRIT request, IL contains an 
integer specifying the number of words transmitted from the remote 
HP 1000 master program to the DS buffer. See Figures 6-3 and 6-4. 

Integer (optional). A word that has meaning only when the condition code 
CCG and an ifun of 5 are returned. In this case, lONU MB E R contzins the 
MPE File System number associated with the completed I/O-without-wait 
request. The default is that no file number is returned. 



(HP 1000) 
MASTER 



(HP 3000) 

SLAVE 





Send reod request and opUonol 
tog rteid. 


\ 


GET 

end count for 
PREAO r«qu«9t} 


PREAD 




^ 





Figure 6-3. GET Activity with PREAD 
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Error Conditions 

CCE 
CCG 



^^ 



CCL 



Figure 6-4. GET Activity with PWRIT 



Request received successfully. 

The implicit IOWAIT(0) call issued by the GET intrinsic completed a pending 
MPE File System I/O-without-wait request instead of a DS remote I/O 
request. The parameter, lONUMBER, contains the file number associated 
with the completed file system request. 

An error occurred. Issue a PCHECK intrinsic call to determine the DS/3000 
subsystem or MPE file system error code. 



NOTE 



You must not use IOWAIT(0) calls within a program containing DS GET 
calls. If you were to use an lOWAIT(O) call and it responded to a DS remote 
I/O request, your program would not be able to understand the information 
returned by the lOWAIT call. 
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PCHECK 



Returns an integer code specifying the completion status of the most recently executed DS 
program-to-program intrinsic. The PCHECK intrinsic may be used in both the master and slave programs. 



Syntax 



I IV 

icode: = PCHECK {DSNUM); 



Functional Return 

When the PCHECK intrinsic is executed, it returns to the calling program a number, icode, that specifies 
the completion status of the most recently executed DS program-to-program intrinsic. The values of 
icode and the associated meanings are described in Appendix A. 



Parameters 

DSNUM 



Integer by value (required). In a master program, DSNUM is the link 
identifier returned by the particular POPEN intrinsic that initiated 
communications with the remote slave program. In a slave program, DSNUM 
is (zero). 



/'^i^ 



Error Conditions 

CCE 
CCG 
CCL 



PCHECK request successfully completed. 

Not returned. 

PCHECK request denied because DSA/i/Wwas invalid. 
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PCLOSE 



r 



Master callable. Terminates program-to-program communciation with a remote HP 1000 slave program. 
The DS line remains open. 



Syntax 



IV 
PCLOSE (DSNUM); 



^N 






Parameters 

DSNUM Integer by value (required). The line number returned by the particular 

POPEN intrinsic call which initiated communication with the remote 
HP 1000 slave program. 



Error Conditions 

CCE Successful completion. 

CCG Not returned. 

CCL Request denied; an error occurred. Issue a PCHECK intrinsic call to 

determine the DS/3000 subsystem or MPE file system error code. 
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NOTE 



Although a master program normally signals the slave program to 
terminate by generating a code in the tag field, PCLOSE can be used to 
terminate the slave program unconditionally. However, make certain the 
HP 1000 slave program is not communicating with other master programs, 
since PCLOSE turns off the slave to other master programs also. 



/^^. 
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PCONTROL 



Master callable. Exchanges tag fields with the remote HP 1 000 slave program. 



Syntax 



IV lA 0-V 

PCONTROL {DSNUM\MlTAG])i 



The PCONTROL intrinsic optionally transmits a tag field to the remote HP 1 000 slave program and accepts 
one in return. The remote HP 1000 slave program must issue a GET intrinsic call followed by either an 
ACEPT or REJCT call to complete the PCONTROL operation. Both the ACEPT and RE JOT calls transmit a 
tag field back to the master program, available in IT AG, 

Although this intrinsic was designed specifically to exchange tag fields, you will notice that ITAG is an 
optional parameter. If the master program did not transmit a tag field, then the returned tag field, if any, 
is not accessible. 

The PCONTROL activity is described in Figure 6-5. 



/S^^ 



Parameters 

DSNUM 
ITAG 



Integer by value (required). The link identifier returned by the particular 
POPEN intrinsic call which initiated communication with the remote 
HP 1000 slave program. 

Integer array (optional). A 20-word array used for transmitting and 
receiving a tag field. The format of the tag field is defined by the master 
and slave programs of the user. 



Error Conditions 

CCE 
CCG 
CCL 



Request accepted by remote HP 1000 slave program. 

Request rejected by remote HP 1 000 slave program. 

Request denied; an error occurred. Issue a PCHECK intrinsic call to 
determine the DS/3000 subsystem or MPE file system error code. 
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PCONTROL 
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Figure 6-5. PCONTROL Activity 
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POPEN 

Master callable. Initiates program-to-program communication with a remote slave program. 

Syntax 



I BA BA lA BA IV IV 

dsnum: = POPEN {DSDEVICE,PROGNAME\iITAG]\M£NTRYNAM]\iPARAM]\iFLAGS] 



IV IV IV IV 

\§STACKSIZE] mOLSIZE] [MMAXDATA] \MBUFSIZE] ) ; 



0-V 



The POPEN intrinsic activates a slave program in the remote HP 1000 having the specified program name, 
PROGNAME, and optionally transmits a tag field, ITAG, to that remote HP 1000 slave program. 

The remote HP 1000 slave program must issue a GET intrinsic call followed by either an ACEPT or REJCT 
call to complete the POPEN operation. 

The remote HP 1000 slave program may transmit a tag field back to the master program as part of an 
ACEPT or REJCT call. If the master program transmitted a tag field, then the returned tag field, if any, is 
available in ITAG. If the master program did not transmit a tag field, then the returned tag field, if any, 
is not accessible. 

The remote HP 1000 slave program remains activated and the communications link intact even if the 
POPEN request is rejected by the remote HP 1000 slave program. The meaning of a POPEN reject by the 
remote HP 1000 slave program must be established as part of the user application design. 

Functional Return 

When the POPEN intrinsic is executed, it returns to the master program a number, dsnum, by which DS 
uniquely identifies the particular communications link. The POPEN activity described below is illustrated 
in Figure 6-6. 

Parameters 

DSDEVICE Byte array (required). Contains a string of ASCII characters terminated by 

a space. This string must be the DS device class name, logical device 
number, or node name for DS/X.2S for the communications line you will 
be using to access the remote HP 1 000, 

PROGNAME Byte array (required). Contains a string of up to five ASCII characters that 

names a remote HP 1 000 slave program. 

ITAG Integer array (optional). A 20-word array used for transmitting and 

receiving tag fields. The format of the tag field is defined as part of the 
user application. Default: A tag field of all zeros is sent; the returned tag 
field, if any, is not available to the master program. 
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POPEN 






ENTRYNAME 

PARAM 

FLAGS 

STACKSIZE 

DLSIZE 

MAXDATA 



These are all MPE parameters used to specify program loading. They are 
ignored when the slave system is an RTE system. The commas must be 
included however since these are positional parameters. 



BUFSIZE 



^^ 



Integer by value (optional). The size in words of the communications 
buffer (DS buffer) that is established by the remote DS software. Note that 
this parameter defines the maximum number of words of data that can be 
transmitted by a PWRITE or PREAD intrinsic call. In the default condition, 
this value is the same size as the line buffer defined by the DSLINE 
command (LINEBUF'^) for the first DSLINE issued to the dsdevice. It will 
never be smaller than 304 words. If no LINEBUF=^ is specified by the first 
DSLINE command, then the default configuration length is used. Must be 
equal to 138 for X.25. This parameter must be specified for a buffer of 
342 words or greater. 






Error Conditions 

CCE 
CCG 
CCL 



Request accepted by remote HP 1000 slave program. 

Request rejected by remote HP 1000 slave program. 

Request denied; an error occured. Issue a PCHECK intrinsic call to 
determine the DS/3000 subsystem or MPE file system error code. 



/p^.. 
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POPEN 
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Figure 6-6. POPEN Activity 
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PREAD 






Master callable. Asks the remote slave program to send a block of data. 



Syntax 




^N 



The PREAD intrinsic transmits a read request to the remote HP 1000 slave program and optionally 
transmits a tag field from ITAG to the remote HP 1000 slave program. The remote HP 1000 slave 
program must issue a GET intrinsic call followed by either an ACEPT or REJCT call to complete the PREAD 
operation. 

The ACEPT call moves the requested block of data from the user's buffer in the remote HP 1000 system to 
TARGET in the master program. 

The REJCT call transmits no data, other than an optional tag field. 

The remote HP 1 000 slave program may transmit a tag field back to the master program as part of the 
ACEPT or REJCT call. If the master program transmitted a tag field, then the returned tag field, if any, is 
available in ITAG, If the master program did not transmit a tag field, then the returned tag field, if any, 
is not accessible. 



Functional Return 



When the PREAD intrinsic is executed, it returns to the master program a number, Igth, specifying how 
many words (if TCOUNT is positive) or bytes (if TCOUNT is negative) of data were actually received into 
TARGET. The PREAD activity is illustrated in Figure 6-7. 



J^N 
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Parameters 

DSNUM 

TARGET 
TCOUNT 



ITAG 



Integer by value (required). The link identifier returned by the particular 
POPEN intrinsic call that initiated communication with the remote slave 
program. 

Integer array (required). The array into which data received from the 
remote slave program will be deposited. 

Integer by value (required). The positive number of words of data or the 
negative number of bytes of data requested. Data buffer sizes can be up to 
512, 1024, or 4096 depending on the buffer size library generated in to the 
HP 1000 system to which the DS line is opened. See the DS/IOOO-IV 
Network Manager^s Manual for details. 

Integer array (optional). A 20-word array used for sending and receiving a 
tag field. The format of the tag field is defined by the master and slave 
programs of the user. 
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PREAD 



Error Conditions 

CCE 
CCG 
CCL 



Request accepted by the remote HP 1 000 slave program. 

Request rejected by the remote HP 1 000 slave program. 

Request denied; an error occurred. Issue a PCHECK intrinsic call to 
determine the DS/3000 subsystem or MPE file system error code. 
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Figure 6-7. PREAD Activity 



>-^^ 



6-18 



PWRITE 






Master callable. Sends a block of data to the remote HP 1000 slave program. 



Syntax 



^^ 



#^ 




The PWRITE intrinsic transmits a block of data from TARGET, and optionally transmits a tag field, ITAG^ 
to the remote HP 1000 slave program. The number of words or bytes to be transmitted is specified in 
TCOUNT. The maximum number of words that may be transferred is 4096. 

The remote slave program must issue a GET call prior to accepting or rejecting the PWRITE request. GET 
returns information to the slave program concerning the nature of the master request, such as the length 
of the PWRITE data. The HP 1000 slave program may optionally receive the PWRITE information with 
the call to GET or wait until calling ACEPT. The remote HP 1000 slave program must issue a GET call 
followed by either an ACEPT or REJCT call to complete the PWRITE operation. 

The remote HP 1 000 slave program may transmit a tag field back to the master program as part of the 
ACEPT or REJCT call. If the master program transmitted a tag field, then the returned tag field, if any, is 
available in IT AG. If the master program did not transmit a tag field, then any returned tag field is not 
accessible. 

The PWRITE activity is illustrated in Figure 6-8. 
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Parameters 

DSNUM 

TARGET 
TCOUNT 



ITAG 



Integer by value (required). The link identifier returned by the particular 
POPEN intrinsic call which initiated communication with the remote 
HP 1000 slave program. 

Integer array (required). The array from which data is transmitted to the 
remote HP 1000 slave program. 

Integer by value (required). The positive number of words of data to be 
transmitted or the negative number of bytes. Data buffer sizes can be up 
to 512, 1024, or 4096 words depending on the buffer size library generated 
in to the HP 1000 that the DS line is open to. See the DS/1000-IV 
Newark Manager's Manual for details. 

Integer array (optional). A twenty-word array used for sending and 
receiving a tag field. The format of the tag field is defined by the master 
and slave programs of the user. 



#^ 
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PWRITE 



Error Conditions 

CCE 
CCG 
CCL 



Request accepted by remote HP 1000 slave program. 

Request rejected by remote HP 1 000 slave program. 

Request denied; an error occurred. Issue a PCHECK intrinsic call to 
determine the DS/3000 subsystem or MPE file system error code. 
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Figure 6-8. PWRITE Activity. 
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REJECT 



Rejects the request received by the most recent GET intrinsic call and returns an optional tag field back to 
the remote HP 1000 master program. 



Syntax 




#^ 



Parameters 

ITAG 



Integer array (optional). A 20-word array used for transmitting a tag 
field. The format of the tag field is defined by the master and slave 
programs of the user. 



#^ 



Error Conditions 

CCE 
CCG 
CCL 



Response transmitted successfully to the remote HP 1 000 master program. 
Not returned. 

An error occurred. Issue a PCHECK intrinsic call to determine the DS/3000 
subsystem or MPE file system error code. 



NOTE 



r 



See Figures 6-1 and 6-2 which appear in the discussion of ACCEPT* 
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PROGRAM EXAMPLES 

The following are examples of master program and slave program pairs. The examples include an 

HP 3000 master - HP 1000 slave pair and an HP 1000 master - HP 3000 slave pair. See the '^ 

DS/IOOO'IV User's Manual for details on the HP 1 000 PTOP calls. _ ^ 

Example 1: HP 3000 Master - HP 1000 Slave 

Master Program on the HP 3000 

This is a master program (JMAST) that runs on the HP 3000 and sends a buffer to a slave program on the 
HP 1 000 where it is reversed and sent back. 

$CONTROL USLINIT 

BEGIN 

COMMENT 

THIS HP 3000 MASTER PROGRAM PROMPTS THE USER FOR A BUFFER 
BE SENT TO THE REMOTE HP 1000 SLAVE PROGRAM WHERE THE BUFFER 
IS REVERSED. THE HP 3000 THEN READS THE REVERSED BUFFER BACK 
AND PRINTS IT ON THE USER'S TERMINAL. ALL COMMUNICATION IS 
ACCOMPLISHED USING THE PTOP INTRINSICS. ; 

INTEGER DSNUM, ICODE, LGTH; 

BYTE ARRAY BUFFER(0:79) ; 

BYTE ARRAY DSLINE(0:7) :="151 "; 

BYTE ARRAY MSG(0:79); 

BYTE ARRAY PROGNAME(0:5) :="JSLAV "; 

ARRAY IBUF(»)=BUFFER; 
ARRAY MSGI(«)=MSG; 



INTEGER ARRAY ITAG(0:19); 

INTRINSIC READ, PRINT, ASCI I; 

INTRINSIC :, fOPEN, PHEAD^PWRITt, PCONTeOi, PCHECK; 

PROCEDURE ERRORPROC(CC); 
VALUE CC; 
INTEGER CC; 

BEGIN 

IF CC=-1 THEN 
BEGIN 



ICODE : =iiliHi(SK ( DSNUM ) ; 
MOVE MSG(6j; 



MOVE MSG(1) 
MOVE MSG(O) 






ASCII (ICODE, 10,MSG(30)); 



=MSG(0),(79); 

="PTOP REQUEST FAILED. ERROR = "; 
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PRINT(MSGI,-33»0); 
END; 

IF CC=1 THEN 
BEGIN 

MOVE MSG:="REHOTE REJECTED REQUEST"; 

PRINT(MSGI,-23,0); 
END; 

END; 

<< BEGIN MAIN CODE>> 

<<POPEN REMOTE HP 1000 SLAVE PROGRAM >> 



JflRN 



r 



i^V 



DSNUM : =iiiiii|ll( DSL I NE , PROGN AME , ITAG) ; 

IF < THEN " 

BEGIN 

ERRORPROC(-I); 
GO TO ENDIT; 
END 

ELSE IF > THEN 
BEGIN 

ERRORPROC(I); 
GO TO ENDIT; 
END 
ELSE 
BEGIN 

MOVE MSG:="POPEN SUCCESSFUL"; 
PRINT(MSGI»-16,0); 
END; 

<< PROMPT USER FOR BUFFER>> 

MOVE MSG:="ENTER BUFFER FOR TEST"; 

PRINT(MSGI,-21,0); 

LGTH:=READ(IBUF,40); 

<<SEND BUFFER TO REMOTE >> 

ITAG(0):=LGTH; 

liiBliKDSNUM, IBUF, LOTH, ITAG) ; 
IF <" THEN 
BEGIN 

ERRORPROC(-I); 
GO TO ENDIT; 
END 
ELSE IF > THEN 
BEGIN 

ERRORPROC(I); 
GO TO ENDIT; 
END 
ELSE 
BEGIN 
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MOVE MSG:="PWRITE SUCCESSFUL"; 
PRINT(MSGI,-17,0); 
END; 
<<GET REVERSED BUFFER FROM REMOTE>> 

LGTH:=iiiiiii(DSNUM,IBUF,40,ITAG); 
IF < thIn" 
BEGIN 

ERRORPROC(-I); 
GO TO ENDIT; 
END 

ELSE IF > THEN 
BEGIN 

ERRORPROC(I); 
GO TO ENDIT; 
END 
ELSE 
BEGIN 

MOVE MSG:="PREAD SUCCESSFUL"; 
PRINT(MSGI,-16,0); 
PRINT(IBUF»LGTH,0); 
END; 

<<SEND PCONTROL TO TELL SLAVE TO ABORT ITSELF >> 
ENDIT: 

I; .Pp<^,TROL (DSNUM , ITAG) ; ^ 

END. 
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Slave Program on the HP 1000 

The following is the HP 1000 slave program that is associated with the HP 3000 master program, JMAST, 
previously illustrated. 

FTN7X 

PROGRAM JSLAV 
C 

C SLAVE. GET BUFFER, REVERSE IT, AND SEND BACK 
C 

INTEGER BUF(40),P(2),CLASS,TAG(20),BUFR(40) 
C 

CALL RMPAR(P) 

CLASS = P(1) 
C 

1 CALL |1P|(CLASS,IER,IFUN,TAG,IL) 

GOTO (iol20,30,40) IFUN 
C 

C OPEN 
C 

10 CALL iiiCiB(TAG,IER) 

GOTO 1 

C 
^\ C READ 

20 CALL ;OApE||(TAG,IER,BUFR) 
GOTO 1 
C 

C WRITE 
C 

30 CALL PACEP|(TAG,IER,BUF) 
C 

^ C REVERSE BUFFER 

DO 31 I = 1,TAG(1) 
J=TAG(1)-I+1 
BUFR(J)=BUF(I) 

31 CONTINUE 
GOTO 1 

C 

C CONTROL 

C 

40 CALL iii|iiii(TAG,IER) 

CALL FIN is 

END 
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Example 2: HP 1000 Master - HP 3000 Slave 



MastCT Program on the HP 1000 

This is a master program that runs on the HP 1000 and sends a buffer to a slave program on the HP 3000 
where it is reversed and sent back. 



PROGRAM JMAST 
C 

C THIS PROGRAM PROMPTS FOR AN INPUT BUFFER ON THE HP 1000» SENDS 
C THE BUFFER TO A SLAVE PROGRAM ON AN HP 3000 WHICH REVERSES THE 
C ORDER AND SENDS IT BACK AT THE REQUEST OF THE 1000 MASTER. 
C 

INTEGER P(5) ,SNAM(3) ,BUF(40) ,PCB(4) ,TAG(20) ,AB(2) ,BUF1 (40) 

INTEGER L0G0N(7),PRMT(6) 

EQUIVALENCE(REG,AB} 
C 

C SNAM = THE NAME OF THE HP 3000 SLAVE PROGRAM 
C LOGON = THE CHARACTER STRING FOR INITIATING A LOGON REQUEST 
C TO THE HP 3000 OPERATING SYSTEM 

C PRMT = THE PROMPT ON THE HP 1000 TO INPUT THE BUFFER TO BE 
C REVERSED 

C 

DATA SNAM/6HJSLAV /, LOGON/1 4HHELL0 RON.DS / 

DATA PRMT/12HINPUT BUFFER/ 
C 

C INITIATE A SESSION ON THE HP 3000 WITH A CALL TO HELLO 
C THE LINK LU OF THE HP 3000 IN THIS CASE IS LU 94 
C 

CALL HELLO (IERR,94, 1 »NMSMP,L0G0N,14) 
C 

C SCHEDULE THE SLAVE PROGRAM ON THE HP 3000 
C 

CALL iipFiS(PCB,IER,SNAM,-94,TAG) 

IF (if|-;Lf. 0) WRITE (1,7) lERJ 
7 FORMAT (" IERR= "»I4," CALL TYPE: ",I2) 
C 

C PROMPT FOR THE BUFFER TO BE REVERSED 
C 40 CHARACTERS MAXIMUM 
C 

REG = DEXEC(-1,1,1+4400B,BUF,40,PRMT,6) 
C 

C SEND THE BUFFER TO THE HP 3000 SLAVE PROGRAM 
C THE LENGTH OF THE BUFFER IS IN THE FIRST WORD OF TAG 
C 

TAG(1) = AB(2) 

CALL ilWRli (PCB,IER,BUF,AB(2),TAG) 
C 
C READ THE REVERSED BUFFER BACK FROM THE HP 3000 SLAVE 
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C LENGTH OF THE BUFFER IS 40 CHARACTERS 
C 

IL = 40 

CALL iiiliP (PCB,IER,BUF1»IL,TAG) 



IF (lER .LT. 0) WRITE (1,7) IER,2 
C 

C PRINT THE RETURNED BUFFER 
C 

WRITE (1,9) BUF1 
9 FORMAT ("BUFFER IS ",/,40A2) 
C 

C CALL PCONT TO TELL THE SLAVE PROGRAM YOU ARE DONE 
C 

CALL •.■PCpNi; (PCB,IER,TAG) 
C 

C CALL BYE TO LOG OFF THE CREATED HP 3000 SESSION ESTABLISHED 
C IN THE CALL TO HELLO 



CALL BYE (IERR,94,1,NMSMP) 
END 
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aave Program on the HP 3000 

The following is the HP 3000 slave program that is associated with the HP 1000 master program, JMAST, 
previously illustrated. 

$CONTROL USLINIT 

PROGRAM JSLAV 
C 

C DECLARE THE PTOP SUBROUTINE CALLS AS SYSTEM INTRINSICS. 

C 

SYSTEM INTRINSIC PEXiACCEPTi^'ftEJECt 

INTEGER BUF(40) ,P(2) ,CLASS,fAG(20) ,BUFR(40) 
C 

C INVOKE THE GET FUNCTION TO WAIT FOR MESSAGES FROM THE 

C MASTER PROGRAM ON THE HP 1000 '^ 

C 

1 IFUN = fGEt(TAG,IL,IONUMB) 
C 

C BRANCH TO THE APPROPRIATE PIECE OF SLAVE CODE TO HANDLE THE 
C FUNCTION CODE RETURNED FROM THE GET 
C 

C FUNCTION CODES ARE: 

C 1 = POPEN, 2 = PREAD, 3 = PWRIT, 4 = PCONT, 5 = NO WAIT I/O 
C 

GOTO (10, 20, 30, 40, 50), IFUN 
C 

C POPEN CALL... CALL ACCEPT TO MASTER 
C AND PERFORM ERROR CHECKING 
C 

10 CALL iBiiiB(TAG) 

IF (.CC.jl1,1»1 

11 lER = iiiHiGi(<(o) 

WRITE (ejooo) lER.I 

GOTO 1 
C 

C PREAD CALL.. CALL ACCEPT TO RETURN REVERSED BUFFER AND DO 
C ERROR CHECKING 
C 

20 CALLiiiPiia(TAG,BUFR,TAG(l)) 

IF (:cic7)ii,i,i 

21 lER = liiHliKO) 
WRITE (6,1000) IER,2 
GOTO 1 

C 

C PWRITE CALL.. CALL ACCEPT TO RETRIEVE BUFFER TO BE REVERSED AND 
C DO ERROR CHECKING 
C 
30 CALL lBGiffl(TAG,BUF,40) 
IF (.CC.)31,33,33 

lER = iiiHiiK(o) ^ 



31 



WRITE (6,1000) IER,3 
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f^ C REVERSE RETRIEVED BUFFER IN DO LOOP 

C 
33 DO 32 I = 1,TAG(1) 

J = TAG(1) -1+1 
BUFR(J) = BUF(I) 
32 CONTINUE 
GOTO 1 
C 

C PCONTROL CALL.. CALL ACCEPT AND STOP PROGRAM 
C 
40 CALL iJiiiiiil(TAG) 

STOP 

C 

C NO WAIT I/O CALL ENCOUNTERED AT GET FUNCTION 
C DISPLAY ERROR INFORMATION AND RETURN TO GET FUNCTION 
^_^ C 

r^ 50 DISPLAY "GET DONE ON NO WAIT I/O, WHICH IS NOT A " 
DISPLAY "DS FUNCTION. RETURN TO GET 
DISPLAY "FILENUMBER = ".lONUMB 
1000 FORMAT ("PTOP ERROR. lERR = ",I5," CALL TYPE: ",12) 
GOTO 1 
END 
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The following is a summary of the messages that may be encountered together with their meanings. The 
messages, as listed here, have been grouped according to their associated activities. For this reason, some 
messages are listed under more than one heading. 

Communications link errors may appear while using the : DSLINE command, Remote File Access (RFA), or 
program-to-program intrinsics. The method of reporting depends on the operation in progress when an 
error occurs. 

If you are performing remote FMP access, the error is returned in the error parameter. 



j^^\ 



If you are using DEXEC calls, the error is returned as a four character ASCII code in the A and B 
registers. 

If you are using program-to-program operations, the error code is returned by the PCHECK intrinsic. 
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:DSLINE Syntax Errors 

These messages are sent to the terminal user to point out an error in syntax or to warn of the 
consequences of a request. 

1300 REMOTE JOBS ARE NOT ALLOWED !. (CIERR 1300) 

1301 DSLINE CANNOT CONTAIN BOTH OPEN AND CLOSE. (CIERR 1301) 

1302 DSLINE REQUIRES AT LEAST ONE PARAMETER. (CIERR 1302) 

1303 DSNUMBER SPECIFICATION MUST BE A NUMBER FROM 1 THRU 255. (CIERR 1303) 

1304 DSLINE #1! DOES NOT IDENTIFY AN OPEN DS LINE. (CIERR 1304) 

1305 EXPECTED LINEBUF, PHNUM, lOCID, REMID, OPEN, CLOSE, QUIET, COMP, NOCOMP, ^ 
OR EXCLUSIVE. (CIERR 1305) 

1306 MULTIPLE USE OF ! IS NOT ALLOWED. (CIERR 1306) 

1307 THE SYNTAX FOR f REQUIRES AN = SIGN FOLLOWED BY DATA. (CIERR 1307) 

1308 PHNUM IS 1 TO 20 DIGITS AND DASHES. (CIERR 1308) 

1309 ! LIST CAN CONTAIN ONLY ONE ELEMENT. (CIERR 1309) /^j. 

1310 THE SPECIFIED LOGICAL DEVICE IS NOT OPEN. (CIERR 1310) 

1311 THE FIRST CHARACTER OF AN ID SEQUENCE MUST BE A " OR A ( (CIERR 1311) 

1312 THE ID SEQUENCE MUST TERMINATE WITH A ). (CIERR 1312) 

1313 THE ID SEQUENCE MUST TERMINATE WITH A ". (CIERR 1313) 

1314 A NUMERIC ID SEQUENCE ELEMENT MUST BE 1 THRU 255 (OR 5^377). (CIERR 1314) ^ 

1315 LINEBUF MUST BE A NUMERIC VALUE FROM 304 THRU 4096. (CIERR 1315) 

1316 UNABLE TO COMPLETE THE REMOTE COMMAND. (CIERR 1316) 

1317 NOT A CURRENTLY AVAILABLE DSLINE. (CIERR 1317) 

1318 USE OF EXCLUSIVE REQUIRES BOTH NS AND CS CAPABILITY. (CIERR 1318) 

1319 THE DS LINE #L» IS IN USE BY A PROGRAM OR SUBSYSTEM AND CANNOT BE CLOSED. 
(CIERR 1319) 

1320 EXPECTED A RESPONSE OF YES, Y, NO, OR N. (CIERR 1320) 

1321 UNABLE TO OPEN THE DS LINE ON DEVICE !. (CIERR 1321) 

1322 @ IS INVALID IN THIS CONTEXT. (CIERR 1322) 
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1323 A DSLINE OPEN REQUIRES A VALID DS DEVICE NAME AS THE FIRST PARAMETER. 
f^ (CIERR 1323) 

1324 FROM ADDRESS MUST BE BETWEEN 1 AND 14 CHARACTERS INCLUSIVE. (CIERR 1324) 

1325 TO ADDRESS MUST BE BETWEEN 1 AND 14 CHARACTERS INCLUSIVE. (CIERR 1325) 

1326 FROM AND TO ADDRESS MUST BE A DECIMAL NUMBER. (CIERR 1326) 

1389 INVALID OR MISSING DELIMITER FOR SELECTION SIGNAL SEQUENCE. (CIERR 1389) 

1390 SELECTION SIGNAL SEQUENCE MUST BE FROM 1 TO 30 CHARACTERS. (CIERR 1390) 

1391 BOTH QUEUE AND NONQUEUE SPECIFIED; NONQUEUE USED. (CIWARN 1390) 

1392 ONLY ! WORDS WERE ALLOCATED FOR THE LINE BUFFER. (CIWARN 1392) 
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1393 COMPRESSION REQUEST NOT HONORED. REMOTE DOES NOT SUPPORT THIS FEATURE. 
(CIWARN 1393) 

1394 COMPRESSION PARAMETER RESPECIFIES AND OVERRIDES PREVIOUS COMPRESSION 
PARAMETER. (CIWARN 1394) 



1395 OPEN PARAMETERS ENTERED ON A CLOSE REQUEST ARE IGNORED (CIERR 1395) 

1396 AN ID LIST MUST CONTAIN 255 OR LESS ELEMENTS. (CIWARN 1396) 
1^***^ 1397 AN UNNECESSARY DELIMITER IS IGNORED. (CIWARN 1397) 

1398 THERE ARE NO DS LINES OPEN, (CIWARN 1398) 

1399 MULTIPLE USE OF ! IS REDUNDANT AND IGNORED. (CIWARN 1399) 



DS/3000 Functional Errors 

These messages report a functional problem within the system. 

201 REMOTE DID NOT RESPOND WITH THE CORRECT REMOTE ID. (DSERR 201) 

202 SPECIFIED PHONE NUMBER IS INVALID. (DSERR 202) 

203 REMOTE ABORT/RESUME NOT VALID WHEN DOING PROGRAM -TO- PROGRAM COMMUNICATION. 
USE LOCAL ABORT/RESUME. (DSWARN 203) 

204 UNABLE TO ALLOCATE AN EXTRA DATA SEGMENT FOR DS/3000. (DSERR 204) 

205 UNABLE TO EXPAND THE DS/3000 EXTRA DATA SEGMENT. (DSERR 205) 

206 SLAVE PTOP FUNCTION ISSUED FROM A MASTER PROGRAM. (DSERR 206) 

207 SLAVE PTOP FUNCTION OUT OF SEQUENCE. (DSERR 207) 
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208 MASTER PTOP FUNCTION ISSUED BY A SLAVE PROGRAM. (DSERR 208) 

209 SLAVE PROGRAM DOES NOT EXIST OR IS NOT PROGRAM FILE. (DSERR 209) 
Creation of Slave Program failed, possibly due to invalid stack size. 

210 WARNING — INVALID MAXDATA OR DLSIZE FOR A SLAVE PROGRAM. SYSTEM DEFAULTS 
ARE IN EFFECT. (DSWARN 210) 

211 SLAVE ISSUED A REJECT TO A MASTER PTOP OPERATION. (DSWARN 211) 

212 FILE NUMBER FROM lOWAIT NOT A DS LINE NUMBER. (DSWARN 212) 

213 EXCLUSIVE USE OF A DS LINE REQUIRES BOTH ND AND CS CAPABILITY. (DSERR 213) 

214 THE REQUESTED DS LINE HAS NOT BEEN OPEN WITH A USER :DSLINE COMMAND OR A 
REQUIRED :REMOTE HELLO HAS NOT BEEN DONE. (DSERR 214) 

215 DSLINE CANNOT BE ISSUED BACK TO THE MASTER COMPUTER. (DSERR 215) ,^ 

216 MESSAGE REJECTED BY THE REMOTE COMPUTER. (DSERR 216) 

217 INSUFFICIENT AMOUNT OF USER STACK AVAILABLE. (DSERR 217) 

218 INVALID PTOP FUNCTION REQUESTED. (DSERR 218) 

219 MULTIPLE POPEN. ONLY ONE MASTER PTOP OPERATION CAN BE ACTIVE ON A DS LINE. 
(DSERR 219) 

220 PROGRAM EXECUTING GET WAS NOT CREATED BY POPEN. (DSERR 220) 

221 INVALID DS MESSAGE FORMAT. INTERNAL DS ERROR. (DSERR 221) 

222 MASTER PTOP FUNCTION ISSUED PRIOR TO A POPEN. (DSERR 222) 

223 REQUEST TO SEND MORE DATA THAN SPECIFIED IN POPEN. (DSERR 223) 

224 FILE EQUATIONS FOR A REMOTE FILE CONSTITUTE A LOOP. (DSERR 224) 

225 CANNOT ISSUE POPEN TO A SLAVE SESSION IN BREAK MODE. (DSERR 225) 

226 SLAVE PROGRAM HAS TERMINATED BEFORE EXECUTING "GET". (DSERR 226) 

227 REMOTE HELLO MUST BE DONE TO INITIATE REMOTE SESSION. DSERR 227) 

228 EXCEEDED MAXIMUM NUMBER OF VIRTUAL CHANNELS PER JOB. (DSERR 228) 

229 TOO MANY DS USERS ON THIS SYSTEM. CANNOT OBTAIN A VIRTUAL PROCESS NUMBER. 
(DSERR 229) 

231 INVALID FACILITY IN CONNECTION REQUEST. (DSERR 231) 

232 THE REMOTE COMPUTER IS NOT OBTAINABLE. (DSERR 232) 

233 VIRTUAL CIRCUIT IS NOT OBTAINABLE. (DSERR 233) 1 
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DS/3000 SUBSYSTEM 

QUEUEING IS REQUIRED TO COMPLETE THE REQUEST. (DSERR 234) 

DS MESSAGE SEQUENCING ERROR. (DSERR 235) 

COMMUNICATIONS HARDWARE HAS DETECTED AN ERROR. (DSERR 236) 

CANNOT CURRENTLY GAIN ACCESS TO THE TRACE FILE. (DSERR 237) 

COMMUNICATIONS INTERFACE ERROR. INTERNAL FAILURE. (DSERR 238) 

COMMUNICATIONS INTERFACE ERROR. TRACE MALFUNCTION. (DSERR 239) 

LOCAL COMMUNICATION LINE WAS NOT OPENED BY OPERATOR. (DSERR 240) 

DS LINE IN USE EXCLUSIVELY OR BY ANOTHER SUBSYSTEM. (DSERR 241) 

INTERNAL DS SOFTWARE ERROR ENCOUNTERED. (DSERR 242) 

THE REMOTE COMPUTER IS NOT RESPONDING. (DSERR 243) 

COMMUNICATIONS INTERFACE ERROR. THE REMOTE COMPUTER RESET THE LINE. 
(DSERR 244) 

COMMUNICATIONS INTERFACE ERROR. RECEIVE TIMEOUT. (DSERR 245) 

COMMUNICATIONS INTERFACE ERROR. REMOTE DISCONNECTED. (DSERR 246) 

COMMUNICATIONS INTERFACE ERROR. LOCAL TIME OUT. (DSERR 247) 

COMMUNICATIONS INTERFACE ERROR. CONNECT TIME OUT. (DSERR 248) 

COMMUNICATIONS INTERFACE ERROR. REMOTE REJECTED CONNECTION. (DSERR 249) 

COMMUNICATIONS INTERFACE ERROR. CARRIER LOST. (DSERR 250) 

COMMUNICATIONS INTERFACE ERROR. LOCAL DATA SET FOR THE DS LINE WENT NOT 
READY. (DSERR 251) 

COMMUNICATIONS INTERFACE ERROR. HARDWARE FAILURE. (DSERR 252) 

COMMUNICATIONS INTERFACE ERROR. NEGATIVE RESPONSE TO THE DIAL REQUEST BY 
THE OPERATOR. (DSERR 253) 

COMMUNICATIONS INTERFACE ERROR. INVALID I/O CONFIGURATION. (DSERR 254) 

COMMUNICATIONS INTERFACE ERROR. UNANTICIPATED CONDITION. (DSERR 255) 

REQUEST QUEUED BEHIND PREVIOUS REQUEST. (DSERR 256) 



|#**S 



A- 5 



DS/3000 SUBSYSTEM 



:DSCONTROL Informatory Messages 

These messages convey status information. 
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MASTER AND SLAVE ACCESS SHUT. 

SLAVE ACCESS OPENED; MASTER ACCESS SHUT. 

MASTER ACCESS OPENED; SLAVE ACCESS SHUT. 

MASTER AND SLAVE ACCESS OPENED. 

TRACE ACTIVATED USING TRACE FILE !. 

TRACE DEACTIVATED. 

MONITORING ACTIVATED. 

MONITORING DEACTIVATED. 

DEBUG MODE ACTIVATED. 

DEBUG MODE DEACTIVATED. 

SPECIAL DEBUG MODE ACTIVATED. 

DEFAULT MODE IS NO COMPRESSION. 

DEFAULT MODE IS COMPRESSION. 

RETRY COUNT NOW EQUALS !. 

CALL REQUEST CANCELLED. 



:DSCONTROL Error Messages 

These messages point out an error in syntax or warn of the consequences of a request. 



4100 NUMBER OF PARAMETERS EXCEEDS MAXIMUM OF !. (CIERR 4100) 

4101 EXPECTED AT LEAST TWO PARAMETERS: A DS DEVICE CLASS/NUMBER AND A FUNCTION 
KEYWORD. (CIERR 4101) 

4102 EXPECTED A DEVICE CLASS NAME OR LOGICAL DEVICE NUMBER FOR ONE OR MORE DS 
DEVICES. (CIERR 4102) 

4103 USER IS NOT ASSOCIATED WITH DS DEVICE !. NO CONTROL FUNCTIONS EXECUTED 
FOR THIS DEVICE. (CIWARN 4103) 

4104 USER IS NOT ALLOWED TO USE :DSCONTROL AND IS NOT ASSOCIATED WITH THE DS 
DEVICE(S). (CIERR 4104) 
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r4105 EXPECTED ONE OR MORE OF THE CONTROL FUNCTIONS: OPEN, SHUT, MON, MOFF, 
COMP, NOCOMP, TRACE, OR DEBUG. (CIERR 4105) 

4106 INVALID CONTROL FUNCTION. EXPECTED ONE OF: OPEN, SHUT, MON, MOFF, COMP, 
NOCOMP, TRACE, OR DEBUG. (CIERR 4106) 

4107 MASTER OVERRIDES PREVIOUS MASTER/SLAVE OPTION. (CIWARN 4107) 

4108 SLAVE OVERRIDES PREVIOUS MASTER/SLAVE OPTION. (CIWARN 4108) 

4109 SPEED OPTION OVERRIDES PREVIOUS SPEED OPTION. (CIWARN 4109) 

4110 OPEN OVERRIDES PREVIOUS OPEN/SHUT FUNCTION. (CIWARN 4110) 

4111 SHUT OVERRIDES PREVIOUS OPEN/SHUT FUNCTION. (CIWARN 4111) 

4112 TRACE OVERRIDES PREVIOUS TRACE FUNCTION (S). (CIWARN 4112) 

4113 DEBUG OVERRIDES PREVIOUS DEBUG FUNCTION (S). (CIWARN 4113) 

4114 MON OVERRIDES PREVIOUS MON/MOFF FUNCTION. (CIWARN 4114) 

4115 MOFF OVERRIDES PREVIOUS MON/MOFF FUNCTION. (CIWARN 4115) 

4116 COMP OVERRIDES PREVIOUS COMP/NOCOMP FUNCTION. (CIWARN 4116) 

4117 NOCOMP OVERRIDES PREVIOUS COMP/NOCOMP FUNCTION. (CIWARN 4117) 

4118 EXPECTED A ";" , "," , OR RETURN AS DELIMITER. (CIERR 4118) 

4119 EXPECTED EITHER A ";" OR RETURN AS DELIMITER. (CIERR 4119) 

4120 EXPECTED A "=" AS DELIMITER FOR SPEED OPTION. (CIERR 4120) 

4121 EXPECTED A "," AS DELIMITER BETWEEN OPTIONS. (CIERR 4121) 

r4122 ILLEGAL OPEN/SHUT OPTION. EXPECTED ONE OF: MASTER, SLAVE, SPEED, OR 
LINESPEED VALUE. (CIERR 4122) 

4123 EXPECTED A POSITIVE DOUBLE VALUE FOR LINESPEED. (CIERR 4123) 

4124 CS CAPABILITY REQUIRED TO USE :DSCONTROL. (CIERR 4124) 

4125 PM CAPABILITY REQUIRED TO USE DEBUG FUNCTION. (CIERR 4125) 

4126 DEBUG FUNCTION MAY ONLY BE USED BY SYSTEM CONSOLE. (CIERR 4126) 

4127 EXPECTED NO OPTION FOR DEBUG OR ONE OF THE FOLLOWING: ON, OFF, OR POSITIVE 
INTEGER VALUE. (CIERR 4127) 

4128 EXPECTED NO OPTION FOR MON/MOFF OR ONE OF THE FOLLOWING: CS OR DS. (CIERR 
4128) 

4129 COMP/NOCOMP FUNCTIONS HAVE NO OPTIONS. (CIERR 4129) 
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4148 INVALID RETRY COUNT, MUST SPECIFY "DEFAULT" OR A NUMBER BETWEEN AND 255 
INCLUSIVE. (CIERR 4148) 

4149 DS DEVICE !: RETRY NOT EXECUTED DUE TO ABOVE. (CIWARN 4149) 

4150 DS INTERNAL FIX NUMBERS DIFFER. (CIWARN 4150) 

4151 INCOMPATIBLE OR MISSING NONCRITICAL DS MODULE: DSCOPY, DSTEST, DS2026, OR 
DS2026CN. (CIWARN 4151) 

4152 CRITICAL DS MODULES ARE INCOMPATIBLE, NO CONTROL FUNCTIONS EXECUTED. 
(CIERR 4152) 

4153 MISSING CRITICAL DS SOFTWARE, NO CONTROL FUNCTIONS EXECUTED. (CIERR 4153) 

4154 TOO MANY DS USERS ON THIS SYSTEM. CANNOT OBTAIN A VIRTUAL PROCESS NUMBER. 
(CIERR 4154) 
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4130 SPEED OPTION IGNORED FOR SHUT FUNCTION. (CIWARN 4130) 

4131 EXTRANEOUS ";" IGNORED. POSSIBLE MISSING FUNCTION? (CIWARN 4131) 

4132 EXTRANEOUS "," IGNORED. POSSIBLE MISSING OPTION? (CIWARN 4132) 

4133 CREATION OF DS MONITOR PROCESS FAILED. (CIERR 4133) 

4134 PROGRAM FILE "DSMON.PUB.SYS" MISSING. (CIERR 4134) 

4135 DS MONITOR UNABLE TO RUN AS A SYSTEM PROCESS. (CIERR 4135) 

4136 CS DEVICE ! IS UNAVAILABLE FOR USE. (CIERR 4136) 

4137 DS DEVICE MUST BE OPEN PRIOR TO USE. (CIERR 4137) 

4138 USER SPECIFIED TRACE FILE NOT ALLOWED WHEN MORE THAN ONE DEVICE IN DEVICE 

CLASS. (CIERR 4138) ^ 

4139 DS DEVICE ! CURRENTLY CONTROLLED ELSEWHERE. (CIWARN 4139) 

4140 DS DEVICE !: OPEN/SHUT NOT EXECUTED DUE TO ABOVE. (CIWARN 4140) 

4141 DS DEVICE !: TRACE NOT EXECUTED DUE TO ABOVE. (CIWARN 4141) 

4142 DS DEVICE !: MON/MOFF NOT EXECUTED DUE TO ABOVE. (CIWARN 4142) 

4143 DS DEVICE !: COMP/NOCOMP NOT EXECUTED DUE TO ABOVE. (CIWARN 4143) 

4144 DS DEVICE !: DEBUG NOT EXECUTED DUE TO ABOVE. (CIWARN 4144) 

4145 NO DS DEVICES REMAINING TO BE CONTROLLED. (CIWARN 4145) 

4146 RETRY OVERRIDES PREVIOUS RETRY FUNCTION. (CIWARN 4146) 

4147 EXPECTED AN "=" AS DELIMITER FOR RETRY FUNCTION. (CIERR 4147) 
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4155 PROMPT OVERRIDES PREVIOUS PROMPT FUNCTION(S). (CIERR 4155) 

4180 REDUNDANT SPECIFICATION OF CANCEL OPTION IGNORED. (CIWARN 4180) 

4181 CANCEL OPTION HAS NO PARAMETERS. (CIERR 4181) 

4182 DS DEVICE ! IS NOT AN X.21 DEVICE; CANCEL NOT EXECUTED. (CIWARN 4182) 

4183 NO CALL REQUEST FOR DE DEVICE !, (CIWARN 4183) 
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These error messages may returned in the I ERR parameter if the condition code = CCE 



Error 
Code 



Meaning 



Corrective Action 



000 
-001 

-002 

-003 

-004 

-005 



-006 



-007 



-008 



-009 



-010 



-Oil 



-012 



No error. 

The disc is down. 

A file already exists with the specified 
name. 

An attempt was made to backspace a 
device or type file that cannot be 
backspaced. 

An attempt was made to create a type 2 
file with too many records, or the record 
size was too large. 

An attempt was made to read or position a 
record not written; or, on update, to write 
an illegal record length. 



An attempt was made to access a cartridge 
or file that cannot be found, or that has no 
more room. 



An attempt was made to access a file with 
no security or the wrong code. 



An attempt was made to open a file that 
was already opened exclusively, or to open 
eight programs, or the cartridge containing 
the file is locked. 

An attempt was made to position a type 
file with DPOSN or to force a type file to 
a type 1. 

Required parameters were omitted from 
the call. 

An attempt was made to access an 
unopened DCB. 

An attempt was made to read, write, or 
position beyond the file boundries. 



None. 

Try again and then report it to the 
system manager of the facility. 

Repeat with a new name or purge the 
existing file. 

Check the device type. 



Check the size parameter. 



Check the position or size parameters. 



Check the file name or cartridge 
number. If there is no more room on 
the cartridge, try another or decrease 
the file size. 

Find out the correct code and use it 
or do not access the file. 



Use CL or DL to locate the lock. If 
the file is being packed, check to see 
if the spool is shut down. 



Check the file type. 



Enter the parameters. 



Use CREATE or OPEN to open DCB; 
check for errors. 

Check the record position parameters; 
the result depends on the file type 
and call 
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Error 






Code 


Meaning 


Corrective Action 


-013 


The cartridge is locked. 


Initialize the cartridge if it is not 
currently initialized; otherwise keep 
trying. 


-014 


No more room in the file directory. 


Purge the files and pack the directory 
if possible, or try another cartridge. 


-015 


The file name does not conform to the 
syntax rules. 


Make corrections to the name. 


-016 


Wrong type of code supplied; an attempt 
was made to create or purge a type file or 
to create a 0-length file. 


Check the size and type parameters. 


-017 


An attempt was made to read, write, or 


Check the file parameters, from 




position a type file that does not support 


FMGR check the name. 




the operation. 




-018 


The destination node does not have FMP. 




-025 


Bad FCODE. Internal RFAM error. 




-026 


Incorrect entry number in RFAM. DCB 
destroyed. 




-028 


There isn't any internal table space in 
RFAM, 




-029 


Internal RFAM tables are invalid. 




-053 


Illegal record size. 




-057 


System table error. 




-059 


Illegal or missing parameters. 





j|Pp)Wlr*v 
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These error messages may be returned in the lERR parameter if the condition code = CCL, otherwise the 
error code is a DS/3000 subsystem error or an MPE file system error. 



Error 
Code 


Meaning 


3 
5 

72 


Not enough parameters. 

Parameter address violation 
at the HP 3000. 

Invalid DS line. 



/"S^ 
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If the condition code = CCG, these four-character ASCII codes are returned in a double word ABREG. 



ifP^. 



^N, 



#»N 



Error 




Code 


Meaning 


DS03 


Illegal record size. 


DS06 


Illegal request 


DS07 


System table error. 


DS09 


Illegal or missing parameters. 


1001 


Illegal or missing parameters. 


1002 


Illegal logical unit 


1003 


Logical unit not assigned. 


1004 


Illegal user buffer. 


1007 


Call rejected by the driver. 


1012 


LU not available to user's session. 


SCOl 


Missing parameter. 


SC02 


Illegal parameter. 


SC03 


Program cannot be scheduled. 


SC05 


Program cannot be defined. 


SC06 


There is no resolution in the DEXEC TIME call. 
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If the condition code = CCL, then a double word ABREG may be one of these binary values, otherwise the ^^^ 

error code is a DS/3000 subsystem error or an MPE file system error. ^j 



Error 
Code 


Meaning 


3 
5 

72 


Not enough parameters. 

Parameter address violation 
at the HP 3000. 

Invalid DS line. 



If condition code = CCE the DEXEC call completed satisfactorily. 
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Before establishing a DS/3000 communications link, the console : DSCONTROL command must be used to 
OPEN a hne so that it is available to DS/3000 users. The : DSCONTROL command allows you to enable or 
disable the DS/3000 subsystem on a specific communications link. 

For easy reference, this command is shown in the following format: 

• SYNTAX Shows the format of the command. 

• PARAMETERS Describes the variables in the command. 

• OPERATION Describes the command in detail. 

• EXAMPLES Shows the command in use. 
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Syntax 



: DSCONTROL dsdeoice [function [... function]] 



where the parameter, function, has the following meanings: 



:s[sr][.t— 1^^^] 



; TRACE 



{: 



,0N [pLL] Wmask] l^umentries] [|pRAP] \Mfilename] 



OFF 



} 



;M0N 
;M0FF 



m 



>--KS"} 



Parameters 

dsdevice 



Required parameter. The logical device number or the device class name 
of the DS/3000 communications device (lODSO or lODSX). On your 
system's I/O configuration listing, the device is back referenced by a pound 
sign (#) to a previously defined INP, HSI, or SSLC. 



OPEN 



For bisync DS/3000 (lODSO), the DS subsystem is enabled but no activity 
is initiated on the communications link. For DS/X. 25 (lODSX), the DS 
subsystem establishes a communications link with the PDN. Makes the 
line available for remote communication via the DS/3000 Subsystem. 



SHUT 



Initiates an orderly line shutdown. Refer to OPERATION for details 
about the line closing procedure. 



/^^ 
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MASTER 



Limits DS/3000 line activity to outgoing requests only. No incoming 
sessions are allowed. 



SLAVE 



Limits DS/3000 line activity to incoming requests only; no outgoing 
activity is allowed. 

Default: Both MASTER and SLAVE processing are allowed. 



line speed 



j|p^''N 



Transmission rate in characters per second (Bit Rate/ 8). This parameter is 
effective only if your system configuration for the line selected 
SPEED CHANGEABLE. Specify linespeed if yours is a European 
installation with modems running at half speed, or if the line is hardwired 
and you want to override the configured default. It may be necessary to 
include this parameter if the length of cables used for HSI communications 
has been changed since the system was configured. 

HSI speed: 250 000 (cable lengths less than 1000 ft.) 

125 000 (cable lengths greater than 1000 ft.) 



j^x 
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INP or SSLC speed: 250, 300, 600, or 1 200 

INP only speed: 2400 (RS232) or 7000 (direct connect on V. 35) 

The SPEED= keyword in the OPEN option may be omitted from a 
: DSCONTROL command. For example, the following two commands have 
exactly the same effect: 

: DSCONTROL 60 ; OPEN , MASTER , SPEED=250000 

: DSCONTROL 60; OPEN, MASTER, 250000 

Remember, both ends of the line must operate at the same speed. 

Default: System configuration values. 



TRACE, ON 



Activates the TRACE facility to provide a record of communications 
activities. Trace parameters are positional. The line must already be open, 
or the OPEN keyword must also be included (to open the line). 



ALL 



Generates trace records for all line activity. 

Default: Records are written only for transmission errors. 



mask 



^PN 



An octal number preceded by a percent sign (%nn). Used to select type of 
trace entries generated. Refer to Sections 3 and 4 in the DS/3000 
HP 3000 to HP 3000 Network Administrator Manual for an explanation 
of the mask bits. Default: %37 (all except PSTN). 
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numen tries 



Decimal integer for the maximum number of entries in a trace record, not 
greater than 248. 

Default: 24. (See OPERATION. ) 



WRAP 



NOTE 



The maximum number of trace entries for an INP is 40. If an error 
message is received indicating insufficient trace memory available on the 
INP, the user must reactivate tracing using the next lower integer multiple 
of eight as the value for numen tries. 



Trace entries that overflow the trace record overlay the prior trace record 
entries. 



Default: Overflow entries are discarded. 



filename 



TRACE, OFF 



A name for the trace file. 

Default: DSTRCxxx • PUB, SYS (where xxx is the LDEV of the dsdeoicel 



Deactivates the TRACE facility, so that no records are kept of DS/3000 
actions, states, and events. Also closes the trace file. 



MON 



[:c1] 



Activates internal communication monitoring activity to give additional 
information on a subsequent cold dump of the system. The line must be 
open for the use of MON, 



HON 



Requests monitoring of all levels of activity. 



MON,DS Requests monitoring at the DS/3000 level of internal 

software operation. 

MON^CS Requests monitoring at the Communication System level of 

internal software operation. 

Default: No monitoring. 

Used only for system troubleshooting. 



MOFF 



Deactivates internal DS/3000 monitor records. Line must be open for the 
use of MOFF. 
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^^ RETRY=r DEFAULT "I Changes the communications error retry count to the specified value. The 

F^ L ^^^^^ J retry counter controls the number of times the system attempts to send or 
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receive a message across the communications link. 
DEFAULT Specifies a limit of 1 5 retries after a line error occurs. 
count Can be any value within the range of to 255. 

Default: 15. 



Operation 

Unless : DSCONTROL is issued from the master console, this command requires the user to have CS and ND 
capability. In addition, all users except the console operator are granted access to : DSCONTROL only if 
they are ALLOWed to use the command and are ASSOCIATEd with the specified DS device. 

Only one DS/3000 communications device can be active (OPEN) on a controller at any given time. Once 
opened (with the : DSCONTROL command), a communications link can be shared by multiple DS/3000 
users. It cannot, however, be shared by users of other communications subsystems supported by your 
system (for example, MRJE). Thus, you must SHUT the DS/3000 communications device before the 
controller can be opened for use by another subsystem. 

Before issuing a : DSCONTROL command, use the : SHOWDEV command to check whether a communications 
link is already established. The LDEV for the INP, SSLC, or HSI port will be UNAVAILable if the 
communications link is in use by any subsystem; the LDEV for a DS/3000 communication device, driver 
lODSO or lODSX, will be AVAILable if it is currently OPEN for use by DS/3000 users. 

If a DS device class includes more than one DS device, the functions specified in the : DSCONTROL 
command apply to all devices in that class. 

If you include more than one function in a : DSCONTROL command, each function (with its subparameter 
list) must be separated by a semicolon, A function that duplicates or conflicts with a previous function 
overrides that function. Functions can appear in any order but are executed in the following order: 

1. OPEN/SHUT 

2. TRACE 

3. MON/MOFF 

The default name of the trace file is: 

DSTRCxxx.PUB.SYS 

where xxx is the logical device number of the dsdeoice. 

If no trace file exists when you turn on the trace facility and you do not specify numen tries, the system 
creates a file to hold 24 entries in each record. 
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When using the bisync protocol, the SHUT parameter initiates an orderly line closing procedure. If no 

sessions or applications are using the line when you shut it, line disconnection occurs immediately. If any ^"^ 

user (including applications) has the line open, the line remains connected until all sessions and ^ ' 

applications CLOSE the line, or until those accessing the line terminate or are aborted. Once SHUT by the 

console operator, no new users may access the line until the operator reopens it. When using the X. 25 

capability of DS/3000, the SHUT parameter disconnects the line immediately, even if there are current 

users on the line. 



NOTE 



Occasionally you may not be able to SHUT a standard (non-X. 25) DS line. 
This could happen, for example, if a DS user forgot to issue a 
:DSLINE xxx;CLOSE command but still has a local session. It could also 
happen if a remote session is "hung. " In such a situation, you can "kill" all 
activity across the line by issuing an :ABORTIO tcxx (where xxx is the 
logical device number of the dsdevice). Following the use of the 
:ABORTIO xxx command, a second iDSCONTROL xxx; SHUT command will 
complete successfully. 



.^ 
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Examples 

To open X. 25 line number 55, thereby making it available for use by DS/3000 users, enter: 
:DSCONTROL 55; OPEN 

To permit the local HP 3000 to process only master (outgoing) requests on DS line number 55, enter: 
iDSCONTROL 55; OPEN, MASTER 

To activate the CS Trace facility for DS line 55 (the line is already open), enter: 
iDSCONTROL 55;TRACE,0N,ALL 

To open X. 25 line 55 and activate CS Trace with a maximum of 40 entries in a trace record, enter: 
iDSCONTROL 55;0PEN;TRACE,0N, , ,40 

To open the line named REMSYS and enable internal monitoring, enter: 
iDSCONTROL REMSYS ;0PEN;M0N 
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This appendix provides a brief discussion on troubleshooting should a failure occur during HP 3000 to 
HP 1000 communications. Your primary source of information during the troubleshooting process will be 
the DS/ 1000" IV Network Manager's Manual, the DS/3000 HP 3000 to HP 3000 User/ Programmer 
Reference Manual, and the DS/3000 HP 3000 to HP 3000 Network Administrator Manual These three 
manuals contain discussions specific to the individual systems for tracing and troubleshooting. 

In order to obtain meaningful troubleshooting information, both the sending and receiving ends must be 
traced. This allows you or an HP Systems Engineer (SE) to compare the message formats from both ends 
to ensure that the message was not altered during transmission of the message. The DS/3000 HP 3000 to 
HP 3000 Network Administrator Manual and the DS/1000-IV Network Manager's Manual contain 
diagrams of the message formats. 

HP 3000 TROUBLESHOOTING AND TRACING 



The DSL I ST program is used to obtain a list of the software module version numbers for the DS/3000, 
X. 25 Link, and CS modules installed on your system. This list is required for all troubleshooting activities 
and must accompany each Service Request (SR) that you submit to your HP Systems Engineer (SE), 



^^\ 



In order to obtain the list, you must have READ access to the DS/3000 program files in PUB. SYS. 
command syntax is: 

:RUN DSLIST.PUB.SYS 



The 



jf^ 



DSTEST is a systems verification test used to check both the system software and the physical link 
between the computer systems. This test is accomplished by transmitting sample messages across the line 
using Remote File Access (RFA) or PTOP. With DSTEST you can select the number of passes, the word 
pattern to be transmitted, the mode of transmission, and the block size. See the DS/3000 HP 3000 to 
HP 3000 User /Programmer Manual for a more detailed discussion of DSTEST. 



NOTE 
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To perform DSTEST you must have established a link to a remote HP 1000 
system using the rDSLINE command. In addition, when using RFA, the 
Remote File Access Monitor (RFAM) must have been scheduled by DIN IT, 
the DS initialization program on the HP 1000. When using PTOP, the 
PTOP communication slave monitor (PTOPM) must be running and the 
slave program, DSTES (DSTEST is the master on the 3000), must be RP*d. 
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Troubleshooting 



The DSTEST program may be executed in two modes* To execute DSTEST in diagnostic mode, enter the 
following command: 

: RUN DSTEST, PUB. SYS, PI AG 

Then respond to the questions as follows: 

. RFA or PTOP? Enter RFA for Remote File Access when testing the HP 1 000 link. PTOP 

capability is supported to the HP 1 000 if the slave (DSTES) is loaded there 
and PTOPM, the HP 1000 program-to-program slave monitor, was 
scheduled by DIN IT. 



.REMOTE COMPUTER? 
.DSLINE? 

.1000 FILE NAME? 

.NUMBER OF PASSES? 
.PATTERN? 



.BLOCK SIZE? 



. CONTINUE (Y/N)? 



Enter 1000 (this question is only asked for RFA). 

Enter the device class or logical device number of the DS line to be 
tested. 

Enter a file name of six or fewer characters, beginning with an alphabetic 
character. The file will be purged upon completion of DSTEST, assuming 
that the test was completed successfully (only asked for RFA). 

Enter the number of passes desired, up to a maximum of 32767. A zero 
or a carriage return causes a default value of one pass to be used. 

Enter an octal word to be transferred. The percent sign indicating octal 
(%) must be entered. An illegal input causes the message, INPUT ERROR, 
to be printed. Enter a correct value or a carriage return to indicate a 
default value, which is 54177777. 

Enter the desired block size of the transfer. For the HP 1000 the block 
size must be less than 5 1 2 words. If a value greater than 5 1 2 is entered, 
an error message is printed. 

Enter a Y to select another set of options, or N to terminate the test. 



^^^'^v 
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A second mode available for DSTEST is called the default mode. To initiate DSTEST in the default mode, 
enter the following: 

; RUN DSTEST. PUB. SYS 

You will then be prompted to enter the DS line you wish to test. DSTEST will then be initiated using one 
pass of PTOP and a 5 1 2 word buffer of all fol 77777' s. 



DSTEST Examples 



DSTEST for PTOP 

i DSLINE 141 

DS LINE NUMBER = #L3 

: RUN DSTEST. PUB. SYS, PI AG 
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r 



HEWLETT PACKARD 32185B.52.00 DSTEST/3000 MON, NOV 4, 1985, 8:32 AM 

.RFA OR PTOP? PTOP 

.DSLINE? ^A^_ 

.NUMBER OF PASSES? 1 

.PATTERN? ^ 

.BLOCK SIZE? 228 

128 WORD PROG TO PROG WRITES DONE: 1 ,SECS: 2.130 ,AVE: 2.130 

.CONTINUE(Y/N)? N 

END OF PROGRAM 



#*** 



DSTEST for RFA 

; DSLINE 141 
OS LINE NUMBER = #L3. 
; RUN DSTEST. PUB.SYS,DI AG 

HEWLETT PACKARD 32185B.52.00 DSTEST/3000 MON, NOV 4, 1985, 8:37 AM 
.RFA OR PTOP? RFA 
.REMOTE COMPUTER? 1000 
.DSLINE? 141 
.1000 FILE NAME? TEMP01 



/f"**^ 



.NUMBER OF PASSES? 22 

.PATTERN? %11 

.BLOCK SIZE? 256 

256 WORD REMOTE RECS WRITTEN/READ: 22 ,SECS: 42.012 ,AVE: 1.909 

.CONTINUE (Y/N)? N 

END OF PROGRAM 



ir 
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TRACING FACILITY. The CS/3000 Trace Facility available on the HP 3000 provides a record of the 
line actions, OS states, and events that occur during DS/3000 operations between computer systems. 

This trace facility is invoked by the operator with a :DSCONTROL command when OPENing the 
communications line, or after the OPEN when the line is active. The CS/3000 Trace Facility will record 
the line activity for a particular communications line until either DS/3000 terminates or the operator 
issues a new :DSCONTROL command with the TRACE, OFF parameter. 

See the DS/3000 HP 3000 to HP 3000 Network Administrator Manual for specific instructions to invoke 
the CS/3000 Trace Facility. 

TRACE FORMATTING. Once the line activity has been recorded using the CS/3000 Trace Facility, 
the data may be formatted for easier interpretation. There are two formatting programs for DS. They 
are CSDUMP and DSDUMP. 
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CSDUMP does some formatting and displays all trace file data in raw form* DSDUMP allows you to 

choose a subset of the trace file to be formatted, and will also analyze the chosen data. In addition, -^^^ 

CSDUMP will display all of the bisynchronous line protocol, while DSDUMP only displays the DS ^ / 

protocol. 

See the DS/3000 HP 3000 to HP 3000 Network Administrator Manual for specifics to use CSDUMP and 
DSDUMP. 

HP 1000 TROUBLESHOOTING AND TRACING 

There are two utility programs which should be run at the HP 1000 end to record, format, and analyze 
traffic sent over the HP 3000 to HP 1 000 PSI and HSI communications link. 

TRACING FACILITIES. LOG3K is a program which initializes logging and is run interactively to 
determine which device or spoolfile the HP 1000 to HP 3000 messages are to be logged, LOG3K is also /"^^ 

used to determine what information is to be logged. / 

Low Level Tracing For HSL The Synchronous Line Control Information (SLCIN) program tracks all 
driver activity (DV667) on the HSI card. Long term statistics and single events are listed. To use this 
program successfully, you need to have a strong understanding of bisync protocol. 

TRACE FORMATTING. TRC3K is the utility program for the HP 1000 which allows you to examine ^^ 

the messages logged by LOG3K. These messages are formatted into readable form by TRC3K. TRC3K is ^^\ 

similar in function to DSDUMP on the HP 3000 side with respect to its formatting function. 

Refer to the DS/ 1000 -IV Network Manager's Manual for a complete discussion of the use of these 
programs. 

Additional HP 1000 Troubleshooting Utilities 

In addition to the previously discussed tracing and formatting utilities, DS/1000-IV provides two other z*^ 

utilities that you may find useful for network maintenance. These utilities are DSINF and DSMOD. ? 

DSINF allows you to examine: 

o The Available Memory Suspend list 

• I/O classes in use 

• DS Values, including Resource Numbers, Class Numbers assigned to DS programs, and time-out 
values 

• The Transaction Control Blocks in the DS SAM block 

• DS Lists 

• Network Routing Vector Specifications /<:^ 



C-4 



J^N 






^^^^' 



^\ 
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• DS Equipment Table entries 

• Synchronous Link Control (DVG67) long term statistics 

• Message Accounting Values 

• Rerouting Values 

• Remote Sessions active at this node 

Once your node has been initialized, you may schedule DSMOD to make adjustments to parameters set 
during initialization. DSMOD allows you to change the HP 3000 ID sequence, re-enable a link, display 
the NRV, change the non-session password, quiesce the node, schedule additional monitors, adjust timing, 
change the default session user name, and change the Nodal Routing Vector. 

Refer to the DS/1000-lV Network Manager's Manual, Vol I and II, for details on both DSINF and 
DSMOD. 
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This section contains information regarding applications on the DS 3000 to 1000 communications link. It 
provides various DS 3000 to 1000 specifications. 



Line Buffer Configuration Limits 



f^ 



SOFTWARE 
HP 3000 
HP 1000 



256 - 4095 words 

The software is loaded using one of the 3 available Libraries. 

304 words maximum 
1072 words maximum 
4096 words maximum 






NOTE 



Continuation records will be used when the 
actual transmitted data exceeds the line 
buffer size. 



j^V 



The entire transfer includes user's data, plus the DS fixed part of the 
message format, plus an optional appendage. 



HARDHARE 



HP 3000 



HP 1000 



INP 304-1024 words maximum 

HSI 304-4095 words maximum 

SSLC 304-4095 words maximum 

PSI 1072 words maximum 

HSI 4096 words maximum 



D-1 



Applications 

Opening a Line from the HP 3000 

To open the DS line from the HP 3000 side, a :DSCONTROL xx;OPEN is done from a system console. 
Then, the command iDSLINE xx is done to open a line to the HP 1000. If the HP 1000 is not ready to 
accept a DSLINE, this will fail, and the message REMOTE NOT RESPONDING will appear. At this point the 
HP 1000 operator must be instructed to open the DS line from the HP 1000 side. To close a DS line, the 
command : DSLINE a:x;CLOSE is done. If an attempt at opening a DS line from the HP 3000 side fails, a 
:DSLINE xx; CLOSE must be done before another attempt at opening the line can be accomplished. 

Opening a Line from the HP 1000 

To open a line from the HP 1 000 side, type the command : RU , DI N IT. DINIT enables the communication 
line interface and schedules the DS monitor and queuing programs that service incoming requests from 
remote network nodes. DINIT schedules QUEX, which is a program used to exchange line open 
information with the HP 3000. After a period of time (if the line fails), QUEX goes into a secondary 
state, and will accept an incoming connection with a HP 3000. The HP 3000 side operator must type in a 
:DSCONTROL xx;OPEN, before a line from the HP 1000 can be opened. To reinstate the HP 1000 side as 
a primary station (allowing you to make the connection from the HP 1 000 side), type the command, 
DSMOD/L 

Session 

Some HP 1 000s have the ability to offer users some isolation from other users through a capability called 
SESSION. SESSION provides a unique environment for each user, where capability levels, private disc 
space, device access, etc. can be specified for each logon account. For instance, if a user wishes to access a 
certain file which resides in a private disc area, the user must logon to an account which has access to that 
area of the disc. 

When accessing an HP 1000 (with Session Monitor installed) from an HP 3000, you may wish to make the 
access under a session. This is done transparently to the HP 3000 user by providing a default logon for 
requests received from the HP 3000. The capability level, disc space, device access, etc. is set up for that 
default session by the HP 1000 Network Manager. This default logon is generally given low capabilities 
as a security measure. For most HP 3000 users, access will be made by interactively (HELLO), or 
programmatically (HELLO command) logging on to a specific account on the HP 1000. The HP 3000 user 
then has the capabilities of that specific logon. For example, if an HP 3000 user wishes to access data 
stored in a private file on the HP 1000, the user will have to issue a logon to a specific account that has 
access to that file before attempting to access the file with remote file access calls. For more details on 
session versus non-session access, refer to "Opening A Line" in Section 2 of this manual. 

It is important to note that the session established on the HP 1000 is a non -interactive session. There is 
no FMGR associated with the session; so the only commands that can be processed are RTE system level 
commands, and DS level DEXEC, RFA, and PTOP calls. 

Running FMGR on tlie HP 1000 

The only method for issuing remote FMGR commands on the HP 1 000 is to place a FMGR transfer file 
on the HP 1000 and then issue the command REMOTE RU,FMGR,trf ile. FMGR will run on the 
HP 1 000, open the transfer file and execute the commands that it contains. The output of the FMGR 
will go to the system console of the HP 1000, 
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CAUTION 



j09f\ 



The request to RU,FMGR causes the actual FMGR program to run (not a 
copy of it). This will tie up FMGR until the transfer file has completed, 
and keep other users on the HP 1 000 from logging on (they will not be able 
to get a copy of FMGR for their session). You must also be very careful to 
EX,SP from FMGR at the end of the transfer file or FMGR will be tied up 
to your session until you terminate it (BYE), or it times out. Exercise 
caution when running FMGR from the HP 3000. 



The MOve Command 

DS/IOOO-IV provides the ability to move files between HP 1000s and HP 3000s with a simple user 
command from RMOTE (the user interface program to the HP 3000). This capability requires 
master-slave software to be installed in both computers. The relocatable %RMOTEl is a version of 
RMOTE that utilizes a slave program, called C0PY3K. PUB. SYS on the HP 3000 to transfer files. The file 
transfer is accomplished with the RMOTE MO command. Refer to the RMOTE section of the 
DS/1000-lV User*s Manual for more information. 



NOTE 
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C0PY3K must exist on the HP 3000 to use the RMOTE MO command. The 
DS/ 1000 -IV Network Manager's Manual, Vol. I, contains installation 
instructions. 



PTOP Testing Using DSTEST 

DS/IOOO-IV provides a slave program, DSTES (%DSTES), which can be loaded on the HP 1000 for 
verification of the DS PTOP software. Load DSTES, and be sure that it is RPed (given an ID segment). 
From the HP 3000, open the DS line to the HP 1000 and run DSTEST for verification of the PTOP 
software. See Appendix C in this manual for more information. 



D-3 



.'1 



^ 



^ 



:^ 



^ 



D-4 



APPENDIX 



j^^ 

m 



^^tes 



Ji^N. 



^^ 



/^*^ 




DS/3000 operation requires the installation and configuration of one communications interface for each 
line to a remote computer. 

This section explains how to configure the following: 

• Intelligent Network Processor (INP) 

• Synchronous Single -Line Controller (SSLC) 

• Hardwired Serial Interface (HSI) 

• DS Line Monitor (communications driver lODSO or lODSX) 

• DS Virtual Terminals (lODSTRMO, lODSTRMX) -- one for each session that will be 

allowed on your system from a remote system. 

The same communications interface (INP, SSLC, or HSI) can be used by another HP 3000 data 
communications subsystem (such as MRJE) when it is not being used by DS/3000, In such a case, the 
communications interface is configured once for each subsystem (each time with a unique logical device 
number, but always with the same DRT number). Keep in mind that the following dialogue applies only 
when the interface is used for DS/3000 activity, and that a response that is optional for DS/3000 may 
not be optional for one of the other subsystems. Configuration guidelines pertaining to the other 
subsystems are given in the reference manual for each subsystem. Configuration summary tables for each 
of the communications interface types are included in the Data Communications Handbook and in the HP 
3000 Computer Systems, System Manager /System Supervisor Reference Manual (HP 3000 Computer 
Systems, MPE V System Operation and Resource Management Reference Manual, if you are using MPE 
V/E). 

For any data communications subsystem to function, CS/3000 modules must be present on the system. It 
is presumed in this configuration description that the Account Systems Engineer (SE) has already installed 
CS/3000. 

If you are making any other changes to the MPE I/O system, refer to the System Manager / System 
Supervisor Reference Manual {HP 3000 Computer Systems, MPE V System Operation and Resource 
Management Reference Manual, if you are using MPE V/E). 

Configuration is accomplished through an interactive dialogue between you and the computer system. As 
the questions or prompts appear on your console, enter the appropriate replies through the console 
keyboard for your desired system configuration. 



NOTE 



In all responses, Y or N can be used for YES or NO. A 
[RETURN! is equivalent to NO. 
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Prior to entering the dialogue, log onto the system and input a file reference to a magnetic tape, as 
follows: 

:FILE name;DEV=TAPE 
sSYSDUMP »name 

The dialogue commences as follows: 



STEP NO. 
1 

2 
3 
4 
5 



DIALOGUE 

ANY CHANGES? YES 



SYSTEM ID = HP 32033 v . uu . f f ? (BlTyRN) 

MEMORY SIZE= xxxx (MIN = yyy,MAX = vvvvv ) ? (RETURNI 

I/O CONFIGURATION CHANGES? YES 

LIST I/O DEVICES? YES 

All I/O devices currently configured on the system are listed with the following 
column headings: 



LOG DEV 
DRT # 

UNIT 
CHAN 
TYPE 
SUB TYPE 
TERM TYPE 
TERM SPEED 
REC WIDTH 
OUTPUT DEV 
MODE 



DRIVER NAME 
DEVICE CLASSES 



Logical device number. 

Hardware device address (Device Reference Table 
number) configured on the interface board. 

Hardware unit number of device on its controller. 

Channel number of device on its controller. 

Device type. 

Device subtype. 

Terminal type. 

Terminal speed. 

Record width in decimal words. 

Device class name or device Idn. 

J >= Accept jobs 
A = Accept data 
I = Interactive device 
D = Duplicative device 
S = Spooled device 

Driver name. 

Class name assigned to the interface. 



.'''^^*?iii\ 



E-2 



Configuration Dialog 



j^^ 



NOTE 



The prompt in Step 6, below, appears only if a 
communications subsystem (CS) device was previously 
configured into the system. 



STEP NO, DIALOGUE 

6 LIST CS DEVICES? YES 

A list of all CS devices currently assigned to the system is printed with the 
following column headings: 



r 



j^^^^. 



^s 



LDN 


Logical device number. 


PM 


Port Mask. (Not used by INP and SSLC) 


PRT 


Protocol. 


LCL MOD 


Local mode. 


TC 


Transmission code. 


RCV TMOUT 


Receive timeout (in seconds). 


LCL TMOUT 


Local timeout (in seconds) 


CON TMOUT 


Connect timeout (in seconds). 


MODE 


= Dial out. 

1 = Manual answer. 

A = Automatic answer. 

D = Dual speed. 

H = Half speed. 

C " Speed changeable. 


TRANSMIT SPEED 


Transmission speed (characters per seconc 


TM 


Transmission mode. 


BUFFER SIZE 


Default buffer capacity, in words. 


DC 


Driver changeable or not changeable. 


DRIVER OPTION 


Driver options. 



r 
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STEP NO. DIALOGUE 



If you have a switched device, such as those that are connected through a dial-up 
telephone line, then you receive the following additional information: 

LDN INP or SSLC logical device number. 

CTRL LEN Not currently implemented. 

PHONE NUMBER LIST A single telephone number -- the default for the 

data communications line. 

LOCAL ID SEQUENCE The default identification of the local computer. 

REMOTE ID SEQUENCE The default identification of the remote computer. 



7 LIST DEVICE DEFAULTS? [RETURN] 

8 HIGHEST DRT=xxx? 

In the output, xxx is a value denoting the present highest DRT entry number 
that can be assigned to a device. 

To change xxx, enter the new value desired. If the highest-numbered device 
in the configuration is a device that uses more than one DRT entry (such as a 
terminal controller with one or two data set controllers), be sure to enter the 
highest of the DRT numbers. 

To maintain the current xxx, enter (RETURN) . 

9 LOGICAL DEVICE #? 

To specify a device to be added or removed, enter the logical device number of 
that device. An HSI has four ports and thus can be configured up to four 
times with a unique logical device number for each port. In addition, a 
communications driver (lODSO) with a unique logical device number must be 
configured for each HSI port configured. 

This prompt is repeated later in the configuration dialogue, so that you can 
return to this point to configure more than one device. 

Entering or [return! will take you to Step 50. 



10 DEVICE NAME? (RETURNl 
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STEP NO. DIALOGUE 
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11 DRT #? 

To add a device, enter its DRT entry number. For a communications driver 
and a virtual terminal, you must assign the logical device number of the 
associated communications interface (INP, SSLC, or the HSI port), preceded by 
a number sign (#). 

Virtual terminals need to be configured for only one port of any HSI (back 
referenced to only one logical device number for the HSI). The terminals will 
be dynamically allocated to the proper port when a user opens it. 

To remove a device and return to Step 9, enter zero. 

12 UNIT #? 

13 SOFTWARE CHANNEL #? 

14 TYPE? 

Enter the device type, where 

16 = Virtual Terminals (lODSTRMO or lODSTRMX) 

1 7 = Intelligent Network Processor (INP) 

18 = Synchronous Single-Line Controller (SSLC) 

1 9 = Hardwired Serial Interface (HSI) 

41 = Communications Driver (lODSO or lODSX) 



^^ 



j^^\ 



NOTE 



When configuring device type 16, consider the maximum 
number of terminals supported by your system. Each 
virtual terminal configured is added to the total number of 
terminals already on the system. This information is 
available from your HP Sales Representative. 
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STEP NO. DIALOGUE 

15 SUB TYPE? 



Communications Interface: 
For an INP, enter 0, 1, or 3 
For an SSLC, enter or 1 
For an HSI, enter 3, where 

« switched line with modem 

1 = nonswitched line with modem or modem eliminator cable 
3 = hardwired line, synchronous transmission 

Communications Driver: 
For lODSO or lODSX, enter or 1, where 

« no data compression 

1 = data compression 

Virtual Terminal: 
For lODSTRMO or lODSTRMX, always enter 8. The 8 is used only for 
HP 3000 to HP 1000 communications. 



NOTE 



If you are configuring a terminal (type 16), the dialogue 
continues to Step 1 6. If you are configuring an HSI (Type 
1 9), the dialogue skips to Step 1 8. If you are configuring an 
SSLC (Type 1 8), the dialogue skips to Step 1 9. If you are 
configuring an INP (type 17), the dialogue skips to Step 22. 
For all other device types, the dialogue skips to Step 36. 



16 ForMPEV/E: 

ENTER [TERM TYPE #] , [DESCRIPTOR FILENAME] ? 



This question is asked only if the device type is 16, or if it is 32 with a 
subtype of 1 4 or 15. Term type is always for DS/3000 Virtual Terminals. 



For MPE IV: 

TERM TYPE? 



This question is asked only if Type is 16. Term Type is always zero for 
DS/3000 Virtual Terminals. 



17 SPEED IN CHARACTERS PER SECOND? 



This question is asked only if device Type is 1 6, then the dialogue skips to Step 
36. 
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STEP NO. DIALOGUE 

V 18 PORTMASK? 

This question is asked only if device Type is 1 9 (HSI), The values allowable 
are shown below and must be entered in decimal. This forms a mask 
indicating which HSI channel will be used. Only one of the four channels 
may be designated for each unique logical device number 

Enter 8 for HSI cable connector port 0. 

Enter 4 for HSI cable connector port 1. 

Enter 2 for HSI cable connector port 2. 

Enter J[ for HSI cable connector port 3. 

Since only one port on the HSI PCA can be opened at a time, only one block of 
virtual terminals (entered later in this configuration) are needed for that HSI 
PCA. This same block is automatically reallocated to each new port opened. 
One block of virtual terminals serves all ports. 

19 PROTOCOL? 1 

This response defines Binary Synchronous Communications. 

r20 LOCAL MODE? 

DS/3000 does not use this response. Enter 1. 
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STEP NO. DIALOGUE 

21 TRANSMISSION CODE? 

For an HSI, enter 1. 



For an SSLC, enter J^ 2, or 3^ where 

1 = Automatic code sensing of ASCII and EBCDIC if 

initially receiving; ASCII if initially sending; 

2 = ASCII transmission. 

3 = EBCDIC transmission. 

In DS/3000, all transmissions are ASCII. Only in certain other data 
communication subsystems can users optionally transfer EBCDIC characters. 



22 RECEIVE TIMEOUT? 



Enter the positive number of seconds the CS device will wait to receive text 
before terminating the read mode. Entering [RETURN! provides a 20-second 
timeout. 



NOTE 



For all timeout responses, entering disables the timeout. 

The maximum timeout is 32000 seconds. DS displays an ^^^^^ 

error when the communications software (CS) disconnects ^ 

because of a timeout. 

23 LOCAL TIMEOUT? 

Enter the positive number of seconds a connected local station will wait to 
transmit or receive before disconnecting. Entering [return! provides a 
60 -second timeout. 

24 CONNECT TIMEOUT? 

Enter the positive number of seconds the local station will wait after one 
attempt to make a connection to a remote station. Entering [return! provides 
a 900-second timeout. For an HSI, 100 to 500 is recommended. For an INP 
or SSLC, 300 is recommended. 
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NOTE 



Steps 25 through 27 apply only to CS devices with switched 
lines connected through a modem (dial telephones, subtype 
0), For CS devices with nonswitched lines connected 
through a modem (private lines, subtype 1), the dialogue 
skips to Step 28. If the CS device is either an HSI or a 
hardwired INP (subtype 3), the dialogue skips to Step 30. 



STEP NO. DIALOGUE 

25 DIAL FACILITY? 



Enter YES if manual dial-up is required. Enter the INP LDEV# if the 
AUTO DIAL feature is used. Enter NO if no dial facility is required. 



26 ANSWER FACILITY? 



Enter YES if the local modem can answer calls, either manually or 
automatically. Enter NO if it cannot. A NO response causes the next step to 
be skipped. 



27 AUTOMATIC ANSWER? 



Enter YES if the local modem can automatically answer calls. Enter NO if 
manual answering is required. 



28 DUAL SPEED? 



Enter YES if the local modem is dual speed (European models). Enter NO if it 
is single speed. A NO response causes the next step to be skipped. 



0^^ 



29 HALF SPEED? 



Enter YES if the local modem is to operate at half speed. Enter NO if it is to 
operate at full speed. The dialogue skips to Step 29. 



30 SPEED CHANGEABLE? 

For an HSI, enter YES. 



For an INP, enter YES if the speed of the line is changeable. Enter NO if the 
line speed is fixed. In general, the speed is changeable when the 
communications interface provides the clocking, and it is not changeable 
when a single -speed modem or other external device provides the clocking. 
You must respond YES if the console operator will be using the speed 
parameter in the :DSCONTROL command to override the configured 
transmission speed (see Step 31). 
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STEP Na DIALOGUE 

31 TRANSMISSION SPEED? 



For INP (Type 1 7) or SSLC (Type 1 8) devices, enter the transmission speed of 
the line in characters per second (Bit Rate/ 8). For HSI (Type 19) devices, 
enter 250000 for cable lengths up to 1000 feet, or enter 125000 for cable 
lengths greater than 1 000 feet 

The transmission speed you specify is ignored for modems that provide 
internal clocking signals. This allows modems of different speeds to be used 
without reconfiguring the Operating System. The speed specified is used if 
the modems are eliminated and the controllers are hardwired together. 

The speed you specify becomes the default. The console operator can override 
the default by including the speed parameter in the : DSCONTROL command, if 
you answered YES to Step 30. 
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STEP NO. DIALOGUE 



32 TRANSMISSION MODE? 
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Enter the appropriate number for the transmission mode in use. The mode 
numbers are: 

= Full duplex 

1 = Half duplex 

INP and SSLC: 

Configure the communications interface (INP or SSLC) to operate in Full 
Duplex (0) if your facility uses one of the following: 

• A leased line with four-wire, point-to-point installation. 

• A dial network with two lines (four-wire equivalent). 

• A dial network with Wide Band Service. 

• Any Direct Connect cable between two INPs. 

Configure the communications interface to operate in Half Duplex (1) if your 
facility uses the following: 

• A dial network with a single -line (two- wire) installation. 

• An INP-to-SSLC Direct Connect cable (a "modem eliminator" cable 

between an INP and an SSLC) 

Your response must agree with the remote system's configuration and with the 
characteristics of the communications line. 

HSI: 

Always configure an HSI as Full Duplex (0). 
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STEP NO. DIALOGUE 

33 PREFERRED BUFFER SIZE? 



Enter, in words, the desired buffer size, to a maximum of 4095 words for an 
HSI or SSLC, or up to a maximum of 1 024 words for an INP. For a dial-up 
line, 1024 is generally recommended; for a leased line with an SSLC, the size 
may be larger than 1024 if the line quality is good. Note that although large 
buffer sizes increase transmission efficiency, they also use up memory space. 
Match buffer sizes for sender and receiver whenever possible, since the 
effective buffer size that can be utilized is the smaller of the two. 



34 DRIVER CHANGEABLE? NO 

35 DRIVER OPTIONS? 



NOTE 
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The dialogue skips to Step 44. 

36 RECORD WIDTH? 

For lODSO and lODSX, enter 1 28. 



For all Virtual Terminals, enter 40. 



37 OUTPUT DEVICE? 

For the communications drivers, enter 0, 



For a virtual terminal, enter the class name or logical device number to be 
used for the corresponding job/session listing device. 



38 ACCEPT JOBS/SESSIONS? 

For the communications drivers, enter NO. 
For virtual terminals, enter YES. 

39 ACCEPT DATA? NO 
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STEP NO. DIALOGUE 

40 INTERACTIVE? 

For the communications drivers, enter NO. 
For virtual terminals, enter YES. 

41 DUPLICATIVE? 

For the communications drivers, enter NO. 
For virtual terminals, enter YES. 

42 INITIALLY SPOOLED? NO 

43 AUTO REPLY? NO 

44 DRIVER NAME? 

Enter the name of the driver for this device as follows: 
lOINPO =INP 
CSSBSCO =SSLC 
CSHBSCO =HSI 

lODSO = Communications driver, while using the Bisync protocol 
lODSX = Communications driver, while utilizing the X. 25 capability 
lODSTRHO = Virtual terminals, while using the bisync protocol 
lODSTRMX = Virtual terminals, while utilizing the X. 25 capability 
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NOTE 



Steps 45 through 48 apply to CS devices with switched 
(dial-up) lines (types 17 and 18, subtype 0). The dialogue 
for all other devices skips to Step 49. 
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STEP NO. DIALOGUE 

45 PHONELIST? 
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Enter YES or NO. 

You can supply one number (usually a frequently dialed number) which will 
be the system default. 



46 PHONE NUMBER? 



Enter a string of numbers and hyphens, but not more than 30 characters. 
This number will be included in the I/O request on the system console when a 
user OPENs a dial-up line. 

The characters that can be used for the phone number are: 

through 9 

/ (separator used for automatic call units that have a second dial tone detect) 

E (optional end-of -number indicator) 

D (one -second delay. Used for European modems and automatic call units 
that require built-in delays) 



# (defined by the local telephone system) 

* (defined by the local telephone system) 
47 LOCAL ID SEQUENCE? 



The default local ID sequence can be specified in ASCII. Enter [RETURN] for a 
null local ID sequence, or enter an ASCII string in quotes. 



NOTE 



Do not enter more than 16 characters for the local or 
remote ID sequence. 
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STEP NO. DIALOGUE 

48 REMOTE ID SEQUENCE? 

Enter the default remote ID sequence in the same format as the local ID 
sequence (above). This can be repeated until (RETURN! is entered. 

49 DEVICE CLASSES? 

Enter a list containing a device class name (up to eight alphanumeric 
characters, beginning with a letter). Class names are separated from each 
other by commas. These names are left to the discretion of the System 
Supervisor. They will be used in certain commands and intrinsics when any 
member of a group of devices (such as any disc drive) can be referenced. No 
name need be entered. 
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When configuring X. 25 devices, the destination logical node 
name cannot be specified as a device class name for lODSX 
or lOINPO entries. 



The dialogue now prints the LOGICAL DEVICE #? prompt described in Step 
9. If all I/O configuration is complete, press (RETURNl and the dialogue 
continues at Step SO. Otherwise, enter a logical device number and repeat the 
configuration procedure from Step 9. 

50 MAX # OF OPEN SPOOLFILES = xxx? (MIN=0. MAX=vvv) tRETURNi 

51 LIST OF I/O DEVICES? YES 

To print a listing of the new input/output device configuration, enter YES. 
This list appears in the format described in Step 5. 

52 LIST CS DEVICES? YES 

Enter YES to list the characteristics of the new CS device configuration. 



NOTE 



Step 53 only appears if you are using MPE V/E. 



53 TERMINAL TYPE CHANGES? 

Enter NO. 
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STEP NO. DIALOGUE 

54 CLASS CHANGES? (RETDrnI 

55 LIST I/O DEVICES? [RETURN! 



NOTE 



The prompt in Step 56 appears only if a CS device is 
configured or if additional drivers exist (for the CS 
driver -changeable option in Step 34). If neither case exists, 
the dialogue skips to Step 5 8. 



56 ADDITIONAL DRIVER CHANGES? NO 

57 I/O CONFIGURATION CHANGES? NO 

58 SYSTEM TABLE CHANGES? NO 

59 MISC CONFIGURATION CHANGES? NO 

60 LOGGING CHANGES? NO 

61 DISC ALLOCATION CHANGES? NO 

62 SCHEDULING CHANGES? NO 

63 SEGMENT LIMIT CHANGES? NO 

64 SYSTEM PROGRAM CHANGES? NO 

65 SYSTEM SL CHANGES? NO 



The NO response assumes CS/3000 modules are already present on the system. ^ 
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rSTEP NO. DIALOGUE 

66 ENTER DUMP DATE? 



[RETURlMl Copies the modified MPE. When this copy is used to COLDSTART 
the system, the account structure and all files remain intact. 

mm/dd/yy where mm/dd/yy is some date in the future. Copies the modified 
MPE and the current accounting, but no files. 

mm/dd/yy where mm/dd/yy is usually the date of the most recent system 
backup. Copies the modified MPE, the current accounting structure, 
and any files that were changed on or since the specified date. 

Copies the entire system (MPE, the current accounting structure, and 

all files). 
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67 ENTER DUMP FILE SUBSETS? 

Enter [RETURNL or enter a filename or series of filenames. (Example: 
@, PUB. SYS) 

68 LIST FILES DUMPED? YES or NO 

69 The console operator must now use the =REPLY command to assign the magnetic tape 
drive on which you have arranged for a tape reel to be mounted. 

After the SYSDUMP is complete, the tape produced should be used to COLDSTART the system. During 
COLDSTART, the old I/O device configuration is replaced with the new one from your SYSDUMP tape. 
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HP ASCII CHARACTER SET 








F 


ASCII 


First Character 


Second Character 




ASCII 


First Character 


Second Character 


Character 


Octal Equivalent 


Octal Equivalent 




Character 


Octal Equivalent 


Octal Equivalent 


A 


040400 


000101 


ACK 


003000 


000006 


B 


041000 


000102 




BEL 


003400 


000007 


C 


041400 


000103 




BS 


004000 


000010 


D 


042000 


000104 




HT 


004400 


000011 


E 


042400 


000105 




LF 


005000 


000012 


F 


043000 


000106 




VT 


005400 


000013 


G 


043400 


000107 




FF 


006000 


000014 


H 


044000 


000110 




OR 


006400 


000015 


1 


044400 


0001 1 1 




SO 


007000 


000016 


J 


045000 


000112 




SI 


007400 


000017 


K 


045400 


000113 




DLE 


010000 


000020 


L 


046000 


000114 




DC1 


010400 


000021 


M 


046400 


000115 




DC2 


011000 


000022 


N 


047000 


000116 




DC3 


011400 


000023 





047400 


000117 




DC4 


012000 


000024 


P 


050000 


000120 




NAK 


012400 


000025 


Q 


050400 


000121 




SYN 


013000 


000026 


R 


051000 


000122 




ETB 


013400 


000027 


S 


051400 


000123 




CAN 


014000 


000030 


T 


052000 


000124 




EM 


014400 


000031 


U 


052400 


000125 




SUB 


015000 


000032 


V 


053000 


000126 




ESC 


015400 


000033 


w 


053400 


000127 




FS 


016000 


000034 


X 


054000 


000130 




GS 


016400 


000035 


Y 


054400 


000131 




RS 


017000 


000036 


z 


055000 


000132 




US 
SPACE 


017400 
020000 


000037 
000040 


a 


060400 


000141 




! 


020400 


000041 


b 


061000 


000142 




" 


021000 


000042 


c 


061400 


000143 




tt 


021400 


000043 


d 


062000 


000144 




$ 


022000 


000044 


e 


062400 


000145 




% 


022400 


000045 


f 


063000 


000146 




& 


023000 


000046 


9 


063400 


000147 




• 


023400 


000047 


h 


064000 


000150 




( 


024000 


000050 


i 


064400 


000151 




) 


024400 


000051 


i 


065000 


000152 




• 


025000 


000052 


k 


065400 


000153 




+ 


025400 


000053 


1 


066000 


000154 




, 


026000 


000054 


m 


066400 


000155 




- 


026400 


000055 


n 


067000 


000156 






027000 


000056 


o 


067400 


000157 




1 


027400 


000057 


P 


070000 


000160 






035000 


000072 


q 


070400 


000161 






035400 


000073 


r 


071000 


000162 




< 


036000 


000074 


s 


071400 


000163 




- 


036400 


000075 


t 


072000 


000164 




> 


037000 


000076 


u 


072400 


000165 




? 


037400 


000077 


V 


073000 


000166 




@ 


040000 


000100 


w 


073400 


000167 




I 


055400 


000133 


X 


074000 


000170 




\ 


056000 


000134 


V 


074400 


000171 




1 


056400 


000135 


z 


075000 


0001 72 




A 


057000 
057400 


000136 
000137 





030000 


000060 




( 


060000 


000140 


1 


030400 


000061 




\ 


075400 


000173 


2 


031000 


000062 




1 


076000 


0001 74 


3 


031400 


000063 




} 


076400 


0001 75 


4 


032000 


000064 






077000 


000176 


5 
6 

7 


032400 
033000 
033400 


000065 
000066 
000067 




DEL 


077400 


000177 




8 


034000 


000070 




9 


034400 


000071 


First Character Second Character 


NUL 
SOH 


000000 
000400 


000000 
000001 




A 


•X 


A 




/- 


^ N 


STX 
ETX 
EOT 


001000 
001400 
002000 


000002 
000003 
000004 


» f \ 
1 1 1 














ENQ 


002400 


000005 




[21 


1 


ill 


3 


4 


5 


6 


7 


8 S 


) 10 


11 1 


2 13 


14 


15 
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ACCEPT, parameters, 6-6 
ACCEPT call, 6-4 

and GET, 6-4 

and PCONTROL, 6-4 

and POPEN, 6-4 

and PREAD, 6-4 

and PWRIT, 6-4 

error conditions, 6-6 

syntax, 6-4 
Adding a communications driver, E-5 
Adding a device, E-5 
Adding a virtual terminal, E- 5 
Adding devices, and maximum number of devices, E- 
ASCII,E-8 
ASCII and EBCDIC, E- 8 



Cable 

Direct Connect, E- 1 1 

modem eliminator, E- 1 1 
Closing a DS line, 1-6 
Closing a line, 2-40 

DSLINE parameters, 2-40 

DSLINE syntax, 2-40 

examples, 2-40 
COLDSTART,E-17 
Communications driver, E- 1 3 

adding, E-5 

with X. 25, E- 13 
Communications Driver, E-5, E-6 
Communications interface, 2-2 

drivers, 2-8 

Hardwired Serial Interface (HSI), 2-2 

Intelligent Network Processor (INP), 2-3 

Programmable Serial Interface (PSI), 2-3 
CS/3000,E-l,E-3 

CS/3000 trace facility for the HP 3000, C-3 
CSDUMP trace formatting program for the HP 3000, C-3 
CSHBSC0,E-13 
CSSBSCO, E-13 
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DAPOS call, 5-5 

error conditions, 5-5 

parameters, 5-5 

syntax, 5-5 
DCLOS call, 5-6 

error conditions, 5-6 

parameters, 5-6 

syntax, 5-6 
DCONT call, 5-8 

error conditions, 5-8 

parameters, 5-8 

syntax, 5-8 
DCRET call, 5-9 

error conditions, 5-10 

parameters, 5-9 

syntax, 5-9 
Default speed, overriding, E- 1 
Device 

adding, E-5 

removing, E-5 
Device Reference Table number, E-2 
Device type, E- 2 
Devices 

switched, E-9, E- 1 3 
DEXEC call elements, 4-3 

functional ret^rii, 4-4 

syntax, 4-3 
DEXEC calls 

capabilities, 4-1 

error checking routine example, 4-4 

I/O CONTROL, 4-10 

I/O STATUS, 4-16 

program example, 4-17 

PROGRAM SCHEDULE, 4-11 

READ, 4-6 ^ 

table of calls and their functions, 4-2 ^ 

TIME REQUEST, 4-13 

TIMED PROGRAM SCHEDULE, 4-14 

WRITE, 4-8 
DEXEC error messages 

condition code » CCG, A-1 3 

condition code «= CCL, A- 14 
Dial networks 

with four wire equivalent, E- 1 1 

with single-line installation, E- 1 1 

with two lines, E- 1 1 

with two-wire installation, E- 1 1 

with Wide Band Service, E-1 1 
Dialing the remote computer, 2-20 

default situation, 2-20 
DINIT, D-2 /^ 

Direct Connect cable, E- 1 1 / 
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Disabling, timeout, E-8 
DLOCF call, 5-11 

error conditions, 5-12 

parameters, 5-11 

syntax, 5-11 
DNAMEcall, 5-13 

error conditions, 5-13 

parameters, 5-13 

syntax, 5-13 
DOPENcall, 5-14 

error conditions, 5-15 

parameters, 5-14 

syntax, 5-14 
DPOSNcall, 5-16 

error conditions, 5-16 

parameters, 5-16 

syntax, 5-16 
DPURG call, 5-17 

error condtions, 5-17 

parameters, 5-17 

syntax, 5-17 
DREAD call, 5-18 

error conditions, 5-18 

parameters, 5-18 

syntax, 5-18 
Driver name, E-2 
Drivers, 2-8 
DRT number, E-2, E-4 
DS Line Monitor, E- 1 
DS/ 3 000 capabilities, 1-1 
DS/3000 functional errors, A- 3 
DSCONTROL 

command execution order, B-5 

examples, B-7 

operation, B-5 

parameters, B-2 

syntax, B-2 
DSCONTROL error messages, A- 6 
DSCONTROL informatory messages. A- 6 
DSDUMP trace formatting program for the HP 3000, C-3 
DSINF, C-4 
DSLINE 

parameters for closing a line, 2-40 

syntax for closing a line, 2-40 
DSLINE command, 2- 1 7 

line buffer considerations, 2-3 

line buffer specification, 2-6 

parameters, 2- 1 7 

specifying ID sequences, 2-20 

syntax, 2- 1 7 
DSLINE syntax errors, A- 2 
DSLIST,C-1 
DSMOD,C-4 
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DSTAT call, 5-19 

error conditions, 5-19 ^ 

parameters, 5-19 ^ 

syntax, 5-19 
DSTEST,C-l,D-3 

default mode, C-2 

diagnostic mode, C-2 

examples, C-2 
Dump date, E- 1 7 
DWIND call, 5-20 

error conditions, 5-20 

parameters, 5-20 

syntax, 5-20 
D WRIT call, 5-21 

error conditions, 5-21 

parameters, 5-21 

syntax, 5-21 



EBCDIC, E- 8 
EBCDIC and ASCII, E- 8 
Editing HP 1000 files, 3-6 
Error messages 

DEXEC,A-13,A-14 

DS/3000 functional errors. A- 3 ,^si^ 

DSCONTROL, A-6 ) 

DSCONTROL informatory messages, A-6 

DSLINE, A-2 

RFA,A-10,A-12 
Establishing a communications link, 3-2 
Establishing a remote session, 3-2 
Examples 

closing a DS line, 1-6 

closing a line with DSLINE, 2-40 ^^^^^ 

DEXEC call error checking routine, 4-4 "^ 

DSCONTROL, B- 7 

establishing multiple lines (hardwired), 2-30 

establishing multiple lines (telephone lines), 2-34 

exclusive option example, 2-23 

FORTRAN program using RFA calls, 5-25 

HP 1000 master - HP 3000 slave PTOP programs , 6-26 

HP 3000 master - HP 1000 slave PTOP programs, 6-22 

initiating a remote session, 1-3 

issuing a remote RTE command, 1-5 

multiple user (dial-up line), 2-24, 2-26, 2-28 

multiple user (hardwired), 2-22 

opening a DS line, 1 - 5 

program using DEXEC calls, 4-17 

RFA error checking routine, 5-3 

running DSTEST, C-2 

SPL program using RFA calls, 5-22 ^^ 
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Exclusive line access, 2-21 
Exclusive option example (hardwired), 2-23 
Executable RTE operator commands, 3-4 
Executable RTE system commands, 3-1 
Executing multiple remote RTE commands, 3-3 
Exiting a remote session, 3-5 



File Management Program (FMGR), 3-6, D- 2 
FMGR, 3-6, D-2 
Four -wire, E-11 
Full Duplex, E- 11 



GET call, 6-7 
error conditions, 6-9 
functional return, 6-7 
parameters, 6-8 
syntax, 6-7 



H 



Half duplex, E- 11 

Hardware and software requirements, 2- 1 

Hardware device address, E-2 

Hardwired Serial Interface, E- 1, E-4, E-5, E-6, E-7, E-8, E-9, E- 1 1, E- 1 3 

adding, E-5 
Hardwired Serial Interface connection, 2-2 
HP 1000 troubleshooting, C-4 

LOG3K,C-4 

rlow level tracing for HSI, C-4 
SLCIN tracing facility, C-4 
trace facilities, C-4 

TRC3K,C-4 
HP 3000 to HP 1000 communications 

capabilities, 1-2 

Hardware requirements, 2-1 

Software requirements, 2-1 
HP 3000 troubleshooting and tracing, C-1 

DSLIST,C-1 

DSTEST,C-1 
HSI, E- 1, E-4, E-5, E-6, E-7, E-8, E-9, E- 1 1, E- 1 3 

adding, E-5 

hardwired sample I/O device table, 2-8 

interface connection, 2-2 

line buffer configuration limits, D- 1 
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I/O CONTROL call, 4- 1 

error conditions, 4-10 

funtional return, 4- 1 

parameters, 4-10 

syntax, 4- 1 
I/O device table samples, 2-8 
I/O devices, E- 2 
I/O STATUS call, 4-16 

error conditions, 4-16 

parameters, 4-16 

syntax, 4- 1 6 
ID sequence exchange, 2-20 

telephone connection, 2-6 
ID sequences, 2-20 

default, 2-20 
Initiating a remote session, 1-3 
INP, E-1, E-3, E-5, E-6, E-9, E-1 3 

adding, E-5 

connection, 2-3 

dialup sample I/O device table, 2-14 

hardwired sample I/O device table, 2-10 

line buffer configuration limits, D- 1 
INP communications interface, telephone connection, 2-5 
INP to PSI 

compared to HSI connection, 2-3 

line buffering, 2-3 

speed capabilities, 2-3 
INP-to-SSLC Direct Connect cable, E-1 1 
Intelligent Network Processor (INP), E-1, E-3, E-5, E-6, E-9, E-13 

adding, E-5 

connection, 2-3 
Interfaces, and use with other subsystems, E- 1 
lODSO, E-1, E-6, E-13 
lODSTRMO, E- 1, E-6, E- 1 3 

lODSTRMX, E- 1, E-6, E- 1 3 ^ 

IODSX,E-l,E-6,E-13 . ^ 

IOINP0,E-13 
Issuing local commands, 3-5 

exiting a remote session, 3-5 
Issuing remote RTE commands, 1-5, 3-2 

executable RTE operator commands, 3-4 

from a batch job, 3-4 



LDEV, E-3 
LDN,E-3 

Leased line, E- 1 1 
Leaving SYSDUMP, E-4, E- 1 5 
Leaving system I/O configuration, E-4 
Leaving system I/O configurator, E- 1 5 
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Limitations 

editing HP 1000 files interactively, 3-6 

interactive access of RTE subsystems, 3-6 

line buffer configuration, D- 1 

running the File Management Program (FMGR), 3-6 
Line buffering, 2-3 

configuration limits, D- 1 

INPtoPSI, 2-3 

telephone connection, 2-6 
Line opening failures, 2-38 
LOG3K,C"4 

LOG3K trace facility for the HP 1000, C-4 
Logical device number, E-3 



M 

Maximum number of devices, E-5 

Modem eliminator cable, E-1 1 

Modems, with internal clocking signals, E- 1 

MOve command on the HP 1 000, D-3 

MPE I/O System, changes to, E- 1 

MPE IV, E-6 

MPE V, E-6 

Multiple line example (hardwired), 2-30 

Multiple line example (telephone lines), 2-34 

Multiple user example (dial-up line), 2-24, 2-26, 2-28 

Multiple user example (hardwired), 2-22 

Multiple user line access, 2-21 



N 

Non-session access versus session access on the HP 1000, 2-5, 2-7, 3-1 



Opening a DS line, 1-5 
Opening a hardwired line, 2-2 
Opening a line, 2-2 

dialing the remote computer, 2-20 

exclusive access, 2-21 

exclusive option example (hardwired), 2-23 

Hardwired, 2-2 

ID sequences, 2-20 

line opening failures, 2-38 

multiple line example (hardwired), 2-30 

multiple line example (telephone lines), 2-34 

multiple lines, 2-29 

multiple user example (dial-up line), 2-24, 2-26, 2-28 

multiple user example (hardwired), 2-22 

multiple users, 2-21 

specifying a line, 2-7 



INDEX-7 



Index 



telephone connection, 2-5 ^,,»^ 

Opening a Line, X, 25 line specification, 2-16 j 

Opening a line from the HP 1 000, D-2 - 

Opening a line from the HP 3000, D-2 
Opening a telephone line, 2-5 

autodial, 2-7 

communications interface, 2-5 

dialing, 2-6 

ID sequence exchange, 2-6 

INP interface, 2-5 

PSI interface, 2-5 

SSLC interface, 2-5 
Opening multiple DS lines, 2-29, 3-2 
Output dev, E- 2 
Overriding default speed, E- 1 

p ^^ 

PCHECK call, 6-10 

error conditions, 6-10 

functional return, 6-10 

parameters, 6-10 

syntax, 6-10 
PCLOSE call, 6-11 

error conditions, 6-11 

parameters, 6-11 -"^^^ 

syntax, 6-11 ^ 

PCONTROL call, 6-12 

error conditions, 6-12 

parameters, 6-12 

syntax, 6-12 
Performance considerations, PTOP versus RFA, 6-3 
Point-to-point, E- 1 1 
POPEN call, 6-14 

error conditions, 6-15 

functional return, 6-14 

parameters, 6-14 

syntax, 6-14 
PREAD call, 6-17 

error conditions, 6-18 

functional return, 6-17 

syntax, 6-17 
PROGRAM SCHEDULE, error conditions, 4-12 
PROGRAM SCHEDULE call, 4- 1 1 

functional return, 4-11 

parameters, 4-11 

syntax, 4-11 
Program-To-Program communications, see PTOP 
Programmable Serial Interface connection, see PSI 
PSI 

connection, 2-3 

line buffering, 2-3 '^ 

line buffer configuration limits, D- 1 
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speed capabilities, 2-3 

telephone connection, 2-5 
PTOP 

buffer size, 6-3 

capabilities, 6-1 

master program calls for the HP 3000 and HP 1000 (table), 6-1 

performance considerations, 6-3 

slave program calls for the HP 3000 and HP 1000 (table), 6-2 
PTOP calls (see also, individual call index listings) 

ACCEPT, 6-4 

GET, 6-7 

HP 1000 master - HP 3000 slave program examples, 6-26 

HP 3000 master - HP 1000 slave program examples, 6-22 

PCHECK, 6-10 

PCLOSE, 6-11 

PCONTROL,6-12 

POPEN,6-14 

PREAD, 6-17 

PWRITE, 6-19 

REJECT, 6-21 
PTOP testing using DSTEST, D-3 
PTOP versus RFA performance considerations, 6-3 
PWRITE call, 6-19 

error conditions, 6-20 

parameters, 6-19 

syntax, 6-19 



READ call, 4-6 

error conditions, 4-7 

functional return, 4-6 

parameters, 4-6 

syntax, 4-6 
Rec width, E-2 
Record width, E-2 
REJECT call, 6-21 

error conditions, 6-21 

parameters, 6-21 

syntax, 6-21 
Remote File Access, see RFA, 5-1 
Remote session capabilities, 3-1 
Removing a device, E-5 
RFA 

capabilities, 5-1 

description of error conditions and parameters, 5-3 

error checking routine example, 5-3 
RFA and FMP cross referencing (table), 5-2 
RFA calls (see also, individual call index listings) 

DAPOS, 5-5 

DCLOS, 5-6 

DCRET, 5-9 

DLOCF, 5-11 
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DNAME, 5-13 ..^ 

DOPEN, 5-14 7 

DPOSN, 5-16 

DPURG, 5-17 

DREAD, 5-18 

DSTAT, 5-19 

DWIND, 5-20 

DWRIT, 5-21 

FORTRAN program example, 5-25 

SPL program example, 5-22 
RFA error messages 

condition code = CCE, A- 1 

condition code « CCL, A- 1 2 
RFA versus PTOP performance considerations, 6-3 
RMOTE,D-3 
RTE subsystems 

interactive access, 3-6 ^^^^^^^ 

limitations to interactive access, 3-6 "^ 



Sample I/O device tables 

HSI hardwired, 2-8 

INPdialup, 2-14 

INP hardwired, 2-10 

SSLCdialup, 2-12 ^ 

Saving SYSDUMP, E-2 / 

Saving System I/O Configuration, E-2 

Session access versus non -session access on the HP 1000, 2-5, 2-7, 3-1 
Sessions access on the HP 1 000, D-2 
SLCIN trace facility for the HP 1000, C-4 
Specifying a line, 2-7 
Speed, overriding default, E- 1 
SSLC, E-1, E-3, E-5, E-6, E-8, E-1 3 

adding, E-5 ^,<;^ 

dialup sample I/O device table, 2-12 ^ 

line buffer configuration limits, D- 1 
SSLC communications interface, telephone connection, 2-5 
Sub type, E-2 

Subsystems, and use with interfaces, E-1 
Subtype, E-6 
Switched devices, E-9, E-1 3 

and SYSDUMP, E-4 

and system I/O configuration, E-4 
Synchronous Line Control Information, see SLCIN 
Synchronous Single-Line Controller, E- 1, E-3, E-5, E-6, E-8, E- 1 3 

adding, E-5 
SYSDUMP, E-1 

leaving, E-4, E-1 5 

saving, E-2 

with switched devices, E- 4 ^^ 

System I/O configuration '"^^ 

leaving, E-4 
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with switched devices, E-4 
^j^r-> System I/O Configuration, E- 1 

:.»- saving, E-2 

System I/O configurator, leaving, E- 1 5 



Term speed, E-2 
Terminal speed, E-2 
Terminating a remote session, 3-S 
TIME REQUEST call, 4- 1 3 

error conditions, 4-13 

parameters, 4-13 

syntax, 4- 1 3 
TIMED PROGRAM SCHEDULE call, 4-14 

error conditions, 4-15 

parameters, 4-14 

syntax, 4- 1 4 
Timeout, disabling, E-8 
Trace formatting for the HP 1000, C-4 
Trace formatting for the HP 3000, C-3 
Tracing facility for the HP 1 000, C-4 
Tracing facility for the HP 3000, C-3 
TRC3K,C-4 

TRC3K for formatting HP 1 000 trace data, C-4 
Troubleshooting the HP 1000, C-4 
Troubleshooting the HP 3000, C-1 
Type, E- 5 
Type 16, E- 6 
Type 19,E-7 
Type 32, E- 6 
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Using the remote subsystem from a batch job, 3-4 



Virtual terminal, E-6, E-1 3 

adding, E- 5 

with X. 2 5, E-1 3 
Virtual terminals, E- 1 
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Wide Band Service, E-1 1 
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WRITE call, 4-8 
error conditions, 4-9 _,- /"^^^ 

functional return, 4-8 >^ _ _ 

parameters, 4-8 
syntax, 4-8 



X.25,E-13 

X. 25 line specification, 2-16 
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